🚀 环境搭建

本部分将详细介绍如何安装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对应的页面中开始调试。