GitHub - sorena-ai/service-catalog-mcp: Service Catalog MCP -- Managing microservices by understanding the codebase

AI-powered platform for making batch code changes across multiple GitHub repositories. Connect any MCP client, describe a change in plain English, and Service Catalog finds the right repos, generates diffs via Claude or Devin, pushes branches, and opens pull requests.

Connect

Hosted service

claude mcp add --transport http service-catalog-mcp https://mcp.infraas.ai

Or add manually to your MCP client config:

{
  "mcpServers": {
    "service-catalog": {
      "url": "https://mcp.infraas.ai"
    }
  }
}

Self-hosted

claude mcp add --transport http service-catalog-mcp http://localhost:8200

See Self-hosting below to start the server locally.

Self-hosting

Prerequisites

Docker and Docker Compose
A GitHub personal access token with repo scope
An Anthropic API key or a Devin account

1. Configure

cp .env.example .env
# Edit .env — at minimum set GITHUB_TOKEN and ANTHROPIC_API_KEY

2. Set up your CLI provider

Service Catalog generates code changes by running a CLI agent inside each cloned repository. Two providers are supported.

Claude (default)

Set in .env:

CLI_PROVIDER=claude
ANTHROPIC_API_KEY=sk-ant-...

That's all — no other setup needed.

Devin

Devin authenticates via a credentials file on your host machine. Set it up once, then mount the file into the container so it persists across restarts.

Step 1 — authenticate on your host:

# Install the Devin CLI if you haven't already
curl -fsSL https://cli.devin.ai/install.sh | bash

# Log in — this saves credentials to ~/.local/share/devin/credentials.toml
devin auth login --force-manual-token-flow

Step 2 — mount the credentials file. Add this volume to the mcp-server service in docker-compose.yml:

volumes:
  - ~/.local/share/devin/credentials.toml:/root/.local/share/devin/credentials.toml:ro
  - batch-workspaces:/var/batch-workspaces
  - repo-clones:/repos

Step 3 — set in .env:

3. Start

The MCP server is available at http://localhost:8200.

4. Connect your MCP client

claude mcp add --transport http service-catalog-mcp http://localhost:8200

How it works

A batch change follows four steps, each confirmed before moving to the next:

Find repos — search_repos finds repos by language, framework, dependency, or a plain-English query.
Plan — propose_plan calls the planner LLM and proposes a per-repo task; adjust with replan or set_repo_subtask before approving.
Diff — start_diffs runs the CLI agent in each repo; wait_for_diffs polls progress; review diffs with chat_repo.
Push & PR — push_repos pushes branches; get_workflow_runs shows CI; create_pr opens pull requests.

Tools

Discovery

Tool	Description
`search_repos`	Search by dependency, language, framework, platform, GitHub Action, or NL query
`get_codebase_glossary`	Project-specific terminology and search hints
`list_repository_groups`	List saved repository groups
`get_repository_group`	Fetch a saved group by name
`list_user_repositories`	All linked repositories with indexing status
`index_repository`	Manually trigger indexing for a specific repo

Batch change

Tool	Description
`propose_plan`	Start a batch — runs the planner and proposes per-repo tasks
`replan`	Re-run the planner with a hint
`set_repo_subtask`	Edit one repo's task description or base branch
`add_repos`	Add repos mid-batch
`remove_repos`	Remove repos from the current batch
`start_diffs`	Kick off the CLI agent for all pending repos
`wait_for_diffs`	Poll diff progress; streams updates, returns after ~25 s
`chat_repo`	Ask questions (`mode="qa"`) or request edits (`mode="edit"`) on a repo's diff
`inspect_batch`	View session status, PR status, or a specific file's diff
`push_repos`	Push branches for ready repos
`create_pr_prep`	Draft PR title and body for each repo
`set_pr_prep`	Edit a repo's PR title or body
`create_pr`	Open pull requests
`update_pr`	Edit an open PR
`close_pr`	Close PRs without merging
`cancel_batch`	Cancel all in-flight tasks and wipe the session

CI/CD

Tool	Description
`get_workflow_runs`	GitHub Actions status across repos — call without args after `push_repos` to check all pushed repos
`get_workflow_jobs`	Per-job/step detail for a run; use `failed_only=True` for triage

Environment variables

Variable	Default	Description
`LOCAL`	`true`	`true` = single-user local mode; `false` = cloud mode (requires Auth0 + MongoDB)
`GITHUB_TOKEN`	—	Personal access token with `repo` scope (local mode)
`CLI_PROVIDER`	`claude`	Code-change agent: `claude` or `devin`
`ANTHROPIC_API_KEY`	—	Required when `CLI_PROVIDER=claude`
`CLAUDE_CLI_DEFAULT_MODEL`	—	Override the model used by the Claude CLI
`DEVIN_MODEL`	—	Override the model used by the Devin CLI
`MONGODB_URI`	—	MongoDB connection string (falls back to TinyDB if unset)
`MONGODB_DATABASE`	`service-catalog`	MongoDB database name
`REDIS_URL`	—	Redis URL (falls back to in-memory cache if unset)
`MCP_PORT`	`8200`	Port the MCP server listens on
`LOG_LEVEL`	`INFO`	Log verbosity
`LANGSMITH_API_KEY`	—	Enable LangSmith tracing (optional)
`CLONE_REPO_BASE_DIR`	`/repos`	Base directory for indexer clones
`BATCH_CLONE_BASE_DIR`	`/var/batch-workspaces`	Base directory for batch change workspaces

Cloud-mode variables (LOCAL=false): MCP_AUTH0_DOMAIN, MCP_AUTH0_CLIENT_ID, MCP_AUTH0_CLIENT_SECRET, MCP_AUTH0_AUDIENCE, MCP_BASE_URL, GITHUB_APP_ID, GITHUB_APP_NAME, GITHUB_PRIVATE_KEY_PATH.

License

MIT — see LICENSE.

推荐订阅源

Show HN