🚀 开发指南

本指南将为你详细介绍项目的开发环境配置、项目设置以及调试方法，帮助你顺利开展开发工作。

🚀 快速开始

📦 安装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，你可以在浏览器中开始调试工作。