使用说明

项目简介

'mcp-python-helper' 是一个基于 Python 开发的 Model Context Protocol (MCP) 服务器，旨在为大型语言模型（LLM）客户端提供 Python 项目的上下文信息和代码操作能力。它通过标准化的 MCP 协议与客户端通信，允许 LLM 客户端调用工具来增强其在 Python 编程方面的辅助功能。

主要功能点

定位 Python 符号 (locate-python-symbol): 允许 LLM 客户端查找 Python 代码中类、函数、变量等符号的定义位置。例如，可以帮助 LLM 理解代码中某个函数或类的具体来源。
编辑 Python 代码 (edit-python-code): 允许 LLM 客户端修改 Python 代码文件，例如在指定位置插入新的代码片段。这使得 LLM 可以进行代码修复、功能添加等操作。

安装步骤

下载仓库: 从 GitHub 仓库 mcp-python-helper 克隆或下载源代码到本地。
安装依赖: 进入仓库根目录，运行命令 'uv sync' 同步项目依赖。确保你已经安装了 'uv' 包管理器。
构建 (可选): 如果需要发布或打包，可以运行 'uv build' 构建项目。

服务器配置

要将 'mcp-python-helper' 配置为 MCP 服务器供客户端使用，您需要在 MCP 客户端的配置文件中添加服务器信息。以下是一个配置示例，通常用于开发环境的客户端配置（例如 Claude Desktop 的开发配置）：

{
  "mcpServers": {
    "mcp-python-helper": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-python-helper",  // 请替换为 mcp-python-helper 仓库的实际路径
        "run",
        "mcp-python-helper"
      ]
    }
  }
}

配置参数说明:

'"mcp-python-helper"': 服务器名称，客户端用此名称标识和调用该服务器。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' 运行器。你需要确保 'uv' 可执行文件在系统 PATH 环境变量中，或者提供 'uv' 的完整路径。
'"args"': 传递给 'uv' 命令的参数列表。
- '"--directory"': 指定项目目录，需要替换为 'mcp-python-helper' 仓库在您本地文件系统中的绝对路径。
- '"run"': 'uv' 命令的子命令，用于运行 Python 包。
- '"mcp-python-helper"': 指定要运行的 Python 包名称，这里指向 'mcp-python-helper' 包。

请注意: 您需要将 '"args"' 中的 '"/path/to/mcp-python-helper"' 替换为您实际存放 'mcp-python-helper' 仓库的路径。

基本使用方法

启动服务器: 配置客户端后，当客户端尝试连接 'mcp-python-helper' 服务器时，客户端会根据您提供的配置启动服务器。
客户端调用工具: 一旦服务器启动并成功连接，客户端就可以发现并调用 'mcp-python-helper' 提供的工具，例如 'locate-python-symbol' 和 'edit-python-code'。具体的调用方式和界面操作取决于 MCP 客户端的实现。通常，您可以在客户端的界面中找到调用工具的入口，并根据工具的输入参数进行操作。例如，在支持代码编辑的 LLM 客户端中，您可能会使用自然语言指令，客户端在后台调用 'locate-python-symbol' 工具来定位代码，或调用 'edit-python-code' 工具来修改代码。

关键词