Github Chat MCP

🚀 GitHub Chat MCP 服务器

GitHub Chat MCP 服务器允许用户借助 GitHub Chat API 对 GitHub 仓库进行索引和提问，为开发者提供了便捷的仓库分析途径。

🚀 快速开始

在使用本服务前，你需要拥有一个 GitHub Chat API 密钥，这是使用服务的必要条件。

📦 安装指南

安装 uv

• MacOS/Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

• Windows：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

不同工具的设置方法

使用 Cursor 进行设置（推荐）

在 mcp.json 中进行如下配置：

{
  "mcpServers": {
    "github-chat": {
      "command": "uvx",
      "args": [
        "github-chat-mcp"
      ]
    }
  }
}

此配置为免费版本，无需额外环境变量。

使用 Claude Desktop 进行设置

# claude_desktop_config.json
# 可以通过以下方式找到位置：
# 点击汉堡菜单 -> 文件 -> 设置 -> 开发者 -> 编辑配置
# 必须先执行：brew install uv
{
  "mcpServers": {
    "github-chat": {
      "command": "uvx",
      "args": ["github-chat-mcp"],
      "env": {
      }
    }
  }
}

通过 Smithery 安装

你可以自动为 Claude Desktop 安装 GitHub Chat：

npx -y @smithery/cli install github-chat-mcp --client claude

💻 使用示例

使用 GitHub Chat with Claude

1. 索引 GitHub 仓库：例如，输入 "分析 React 仓库"。
2. 询问仓库相关问题：例如，输入 "这个仓库的核心技术栈是什么？"

调试

运行以下命令进行调试：

npx @modelcontextprotocol/inspector uvx github-chat-mcp

📚 详细文档

本地开发环境配置说明

克隆代码库

git clone https://github.com/yourusername/github-chat-mcp.git

安装依赖项

1. 安装 uv（同安装指南中的步骤）。
2. 安装 MCP 服务器的依赖项：

cd github-chat-mcp

# 创建虚拟环境并激活它
uv venv

source .venv/bin/activate # MacOS/Linux
# 或者
.venv/Scripts/activate # Windows

# 安装依赖项
uv sync

使用 Claude Desktop 进行配置

使用 MCP CLI SDK

# 如果你还没有安装，请先执行 `pip install mcp[cli]`
mcp install /ABSOLUTE/PATH/TO/PARENT/FOLDER/github-chat-mcp/src/github_chat_mcp/server.py -v "GITHUB_API_KEY=API_KEY_HERE"

手动配置

# claude_desktop_config.json
# 可以通过以下方式找到位置：
# 点击汉堡菜单 -> 文件 -> 设置 -> 开发者 -> 编辑配置
{
  "mcpServers": {
    "github-chat": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/github-chat-mcp",
        "run",
        "github-chat-mcp"
      ],
      "env": {
      }
    }
  }
}

使用 GitHub Chat with Claude

使用方法同前面的使用示例。

调试

• 若已安装 MCP CLI (pip install mcp[cli])：

mcp dev /ABSOLUTE/PATH/TO/PARENT/FOLDER/github-chat-mcp/src/github_chat_mcp/server.py

• 若未安装：

npx @modelcontextprotocol