Github Oauth MCP Server

🚀 開發指南

本指南將為你詳細介紹項目的開發環境配置、項目設置以及調試方法，幫助你順利開展開發工作。

🚀 快速開始

📦 安裝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桌面應用程序，你需要更新claude_desktop_config.json文件以註冊工具。

找到claude_desktop_config.json的位置

根據不同的操作系統，使用以下命令找到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

添加配置內容

請將以下內容添加到配置文件中：

{
  "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。

你可以通過以下命令啟動MCP Inspector：

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

啟動後，Inspector會在瀏覽器中顯示一個URL，你可以在瀏覽器中開始調試工作。