github-twin

Developer Tools Python v0.0.17

Personal RAG over your GitHub history (commits, code, reviews), served to Claude Code over MCP.

View source ↗ Generate config for multiple servers More servers

Install

Pin version registry version 0.0.17

Python
uvx github-twin

Python
uvx github-twin@0.0.17

Setup by client

Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.

claude_desktop_config.json

{
  "mcpServers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin@0.0.17"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
      }
    }
  }
}

Format verified against the official Claude Desktop docs ↗.

terminal

claude mcp add --env GITHUB_TOKEN=<YOUR_GITHUB_TOKEN> --env ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY> --env GEMINI_API_KEY=<YOUR_GEMINI_API_KEY> github-twin -- uvx github-twin

claude mcp add --env GITHUB_TOKEN=<YOUR_GITHUB_TOKEN> --env ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY> --env GEMINI_API_KEY=<YOUR_GEMINI_API_KEY> github-twin -- uvx github-twin@0.0.17

Format verified against the official Claude Code docs ↗.

.cursor/mcp.json

{
  "mcpServers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin@0.0.17"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
      }
    }
  }
}

Format verified against the official Cursor docs ↗.

.vscode/mcp.json

{
  "servers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
      }
    }
  }
}

{
  "servers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin@0.0.17"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
      }
    }
  }
}

Format verified against the official VS Code docs ↗.

mcp_config.json

{
  "mcpServers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin@0.0.17"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>"
      }
    }
  }
}

Format verified against the official Windsurf docs ↗.

Environment variables

Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.

GITHUB_TOKEN secret — GitHub personal access token. Optional: github-twin can also pick the token up from `gh auth token` or from its own OAuth device-flow login (`gt auth login`).
ANTHROPIC_API_KEY secret — Optional. Enables the Claude backend for `gt summarize`, `gt distill`, and `gt eval`. Defaults to local Ollama when unset.
GEMINI_API_KEY secret — Optional. Enables the Gemini backend for embedding and the LLM seam. Vertex AI ADC via `GT_GEMINI_PROJECT` is also supported.
GT_PATHS__DATA_DIR — Optional. Override the on-disk data directory holding the SQLite index, embeddings, and cached GitHub responses. Defaults to `$XDG_DATA_HOME/github-twin`.

GitHub

最近更新于 119 天前 · MIT license

About this server

github twin You reviewed a permission check six months ago. Claude doesn't remember it. github twin does — it indexes your commits and review comments, and surfaces them as retrieval hits whenever an agent writes or reviews new code in your style.…

Summary from the project README — github.com/ChristopherDavenport/github-twin

Distributed as Python, listed under Developer Tools. Review our MCP security guide before granting access to real data.

Frequently asked questions

What does the github-twin MCP server do?

How do I install github-twin?

Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.

Is github-twin free to use?

The MCP server itself is free to install. The source is public on https://github.com/ChristopherDavenport/github-twin. Any third-party service it calls may require its own API key and account.

Which clients support github-twin?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.

Add this badge

Publish this server? Link back with a badge on your README or site — copy either snippet.

Markdown

[![Listed on MCPNav](https://mcpnav.net/badge/github-twin.svg)](https://mcpnav.net/server/github-twin/)

HTML

<a href="https://mcpnav.net/server/github-twin/"><img src="https://mcpnav.net/badge/github-twin.svg" alt="Listed on MCPNav" height="20"></a>