@repotrix/mcp

Give your AI coding assistant grounded, always-fresh answers about your repositories via the Model Context Protocol. This package is a small local bridge that connects Claude Code, Cursor, Windsurf, or Copilot to your Repotrix workspace.

It exposes these tools:

| Tool | What it does | |---|---| | list_repos | List the repositories in your Repotrix workspace | | ask_codebase | Ask a question and get a grounded, citation-backed answer (graph-aware RAG) | | search_code | Semantic code search — find where something lives | | get_architecture | Architecture summary + Mermaid diagram + docs excerpt | | whats_changed | Recent drift events — what changed and what it affected |

No codebase data is stored by this bridge — it's a thin proxy to the Repotrix API authenticated with your Personal Access Token.

1. Get a token

In Repotrix: Settings → Connect your AI assistant → Create token. Copy it (shown once).

2. Add it to your AI tool

Claude Desktop / Claude Code (claude_desktop_config.json), Cursor (~/.cursor/mcp.json), or Windsurf:

{
  "mcpServers": {
    "repotrix": {
      "command": "npx",
      "args": ["-y", "@repotrix/mcp"],
      "env": {
        "REPOTRIX_TOKEN": "rpx_pat_xxxxxxxx"
      }
    }
  }
}

Self-hosted / different region? Add "REPOTRIX_API": "https://api.your-host.com" to env.

Restart your AI tool. Ask it: "Use repotrix to list my repos, then explain how auth works in ."

Environment variables

| Var | Required | Default | |---|---|---| | REPOTRIX_TOKEN | yes | — | | REPOTRIX_API | no | https://api.repotrix.ai |

Local development

npm install
npm run build
REPOTRIX_TOKEN=rpx_pat_xxx node dist/index.js   # speaks MCP over stdio

License

MIT