Github (via OAuth)

🚀 環境搭建

本部分將詳細介紹如何安裝uv，搭建Python項目和環境，以及如何配置Claude桌面應用程序，最後還會提供調試相關的建議。

📦 安裝uv

首先，我們需要安裝uv並設置Python項目和環境。根據不同的操作系統，可使用以下命令進行安裝：

# MacOS/Linux系統
MacOS/Linux : curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows系統
Windows : powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安裝完成後，請務必重啟終端，以使uv命令生效。

📁 創建並設置項目

接下來，我們將創建並設置項目，以本地運行Claude桌面應用程序。

註冊工具

需要更新claude_desktop_config.json文件來註冊工具。該文件在不同操作系統中的位置如下：

# Windows系統
Windows : code $env:AppData\Claude\claude_desktop_config.json
# Mac/Linux系統
Mac/Linux :code ~/Library/Application\ Support/Claude/claude_desktop_config.json

配置文件示例

以下是claude_desktop_config.json文件的示例：

{
  "mcpServers": {
    "Github-Oauth": {
      "command": "C:\\Users\\Hp\\.local\\bin\\uv",
      "args": [
        "--directory",
        "C:\\Users\\Hp\\Github-Oauth\\src\\github_oauth",
        "run",
        "server.py"
      ]
    }
  }
}

🔧 調試

由於MCP服務器通過stdio運行，調試可能會有一定的挑戰性。為了獲得最佳的調試體驗，我們強烈推薦使用MCP Inspector。

您可以通過npm使用以下命令啟動MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory C:\Users\Hp\Github-Oauth run github-oauth

啟動後，Inspector將在瀏覽器中顯示一個URL，您可以在該URL對應的頁面中開始調試。