使用说明

项目简介

本项目实现了一个基于 Model Context Protocol (MCP) 的服务器，为LLM（大型语言模型）客户端提供 Python REPL (Read-Eval-Print Loop) 环境作为工具。通过这个服务器，LLM可以执行Python代码，利用Python强大的生态系统和计算能力来增强自身的功能。服务器保持会话状态，允许变量在多次代码执行之间持久存在，并支持安装第三方Python包。

主要功能点

Python 代码执行: 允许LLM客户端发送Python代码到服务器执行，并返回代码执行的输出结果或错误信息。
会话变量管理: 在服务器端维护一个持久的Python会话，多次执行代码之间变量保持不变，LLM可以逐步构建和利用上下文信息。
Python 包安装: 支持LLM客户端请求服务器安装指定的Python包，从而扩展Python REPL的功能，例如使用特定的库进行数据处理或网络请求。

安装步骤

本项目无需复杂的安装步骤，因为它使用 'uv' 进行依赖管理。确保你已经安装了 'uv'。如果没有安装，请参考 'uv' 的官方文档进行安装。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，你需要在客户端的配置文件中添加服务器的启动配置。以下是一个示例 JSON 配置，你需要根据实际情况进行调整：

{
  "mcpServers": {
    "python-repl": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/python-repl-server",
        "run",
        "src/mcp_python/server.py"
      ]
    }
  }
}

配置项说明:

'server name': 'python-repl' (服务器名称，客户端用此名称来标识和调用该服务器)
'command': 'uv' (启动服务器的命令，这里使用 'uv run' 来运行Python脚本)
'args': 启动命令的参数列表
- '--directory': '/absolute/path/to/python-repl-server' (请替换为 'mcp-python' 仓库在你的系统中的绝对路径) - 指定 'uv run' 命令的工作目录为仓库根目录。
- 'run': 'uv run' 命令的一部分，用于运行指定的Python脚本。
- 'src/mcp_python/server.py': 服务器主程序 Python 脚本的路径。

请务必将 '/absolute/path/to/python-repl-server' 替换为你本地 'mcp-python' 仓库的绝对路径。

基本使用方法

配置完成后，在 MCP 客户端中，你可以使用以下工具与 Python REPL 服务器进行交互：

'execute_python': 执行Python代码。
- 参数:
  - 'code' (字符串, 必填): 要执行的Python代码。
  - 'reset' (布尔值, 可选, 默认: 'false'): 如果设置为 'true'，则在执行代码前重置Python会话，清除所有已定义的变量。
'list_variables': 列出当前Python会话中已定义的所有变量。
- 无需参数。
'install_package': 安装Python包。
- 参数:
  - 'package' (字符串, 必填): 要安装的Python包的名称 (例如: 'requests')。

在LLM客户端中，你需要根据客户端的具体使用方式来调用这些工具，通常是在对话或指令中指定工具名称和参数。

关键词