GitHub Chat MCP

一个用于分析和查询 GitHub 仓库的 Model Context Protocol (MCP)，它使用 GitHub Chat API。

安装

# 使用 pip 安装
pip install github-chat-mcp

# 或者使用更新的 uv 包管理器安装
uv install github-chat-mcp

3. 开始与 Claude 一起使用！

示例提示：

• "使用 github-chat-mcp 分析 React 仓库"
• "使用 github-chat-mcp 索引 TypeScript 仓库并询问其架构"

GitHub Chat MCP 服务器

设置说明

首先，请确保您拥有 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
# 可以通过以下方式找到位置：
# 汉堡菜单 -> 文件 -> 设置 -> 开发者 -> 编辑配置
{
  "mcpServers": {
    "github-chat": {
      "command": "uvx",
      "args": ["github-chat-mcp"],
      "env": {
      }
    }
  }
}

通过 Smithery 安装

您可以通过 Smithery 自动为 Claude Desktop 安装 GitHub Chat：

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

将 GitHub Chat 与 Claude 结合使用

1. 首先索引一个 GitHub 仓库： "索引位于 https://github.com/username/repo 的 GitHub 仓库"

2. 然后询问有关该仓库的问题： "此仓库中使用的核心技术栈是什么？"

调试

运行：

npx @modelcontextprotocol/inspector uvx github-chat-mcp

本地/开发 设置说明

克隆仓库

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

安装依赖

首先安装 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"

然后安装 MCP 服务器依赖项：

cd github-chat-mcp

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

source .venv/bin/activate # MacOS/Linux
# OR
.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 与 Claude 结合使用

1. 首先索引一个 GitHub 仓库： "索引位于 https://github.com/username/repo 的 GitHub 仓库"

2. 然后询问有关该仓库的问题： "此仓库中使用的核心技术栈是什么？"

调试

运行：

# 如果安装了 mcp cli (`pip install mcp[cli]`)
mcp dev /ABSOLUTE/PATH/TO/PARENT/FOLDER/github-chat-mcp/src/github_chat_mcp/server.py

# 如果没有安装
npx @modelcontextprotocol/inspector \
      uv \
      --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/github-chat-mcp \
      run \
      github-chat-mcp

然后访问 MCP Inspector，地址为 http://localhost:5173。 您可能需要在 inspector 的环境变量中添加您的 GitHub API 密钥，变量名为 GITHUB_API_KEY。

注意

• 可以通过 FASTMCP_LOG_LEVEL 环境变量调整日志记录级别（例如 FASTMCP_LOG_LEVEL="ERROR"）
• 此 MCP 服务器提供两个主要工具：
  1. 仓库索引 - 索引和分析 GitHub 仓库
  2. 仓库查询 - 询问有关索引仓库的问题