Github Chat

🚀 使用 GitHub Chat MCP 分析和查詢GitHub倉庫

GitHub Chat MCP（Model Context Protocol）是用於通過 GitHub Chat API 分析和查詢GitHub倉庫的協議。藉助該協議，用戶能夠方便地對 GitHub 倉庫進行索引和查詢操作。官方網址：https://github-chat.com

🚀 快速開始

要開始使用 GitHub Chat MCP，你可以按照以下步驟操作：

1. 完成安裝（具體安裝步驟見下文“📦 安裝指南”）。
2. 開始與Claude一起使用它！以下是示例提示：
   • "使用github - chat - mcp分析React倉庫"
   • "用github - chat - mcp索引TypeScript倉庫並詢問其架構"

✨ 主要特性

• 倉庫索引：能夠對指定的 GitHub 倉庫進行索引和分析。
• 倉庫查詢：支持對已索引的倉庫進行查詢，獲取相關信息。

📦 安裝指南

你可以選擇以下方式進行安裝：

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

# 或使用較新的 uv 包管理器安裝
uv install github-chat-mcp

📚 詳細文檔

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
# 可以通過以下步驟找到位置：
# 點擊漢堡菜單 -> 文件 -> 設置 -> 開發人員 -> 編輯配置
# 必須先執行：brew install uv
{
  "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"

然後在GitHub Chat - 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",
        "github-chat-mcp"
      ]
    }
  }
}

使用GitHub Chat與Claude

1. 首先索引一個GitHub倉庫：
   • 發送/index <repository-url>命令，例如：/index https://github.com/yourusername/repo
2. 然後查詢索引的倉庫：
   • 發送/query <question>命令，例如：/query 這個倉庫的核心技術棧是什麼？

注意事項

⚠️ 重要提示

• 通過環境變量 FASTMCP_LOG_LEVEL 可以調節日誌級別（例如：FASTMCP_LOG_LEVEL="ERROR"）
• 此MCP服務器提供兩個主要功能：
  1. 倉庫索引 - 索引和分析一個GitHub倉庫
  2. 倉庫查詢 - 查詢已索引的倉庫