使用说明

项目简介

ForeverVM MCP服务器基于 Model Context Protocol (MCP) 构建，旨在为大语言模型 (LLM) 客户端提供执行 Python 代码的能力。它允许 LLM 客户端安全地运行 Python 代码片段，并管理 REPL 会话，以实现状态保持和复杂计算。

主要功能点

• Python 代码执行: 允许 LLM 客户端在隔离的 Python 环境中执行代码。
• REPL 会话管理: 支持创建和管理 REPL 会话，保持会话状态，以便在多次调用之间共享变量和函数定义。
• 工具注册和调用: 通过 MCP 协议将 Python 代码执行功能注册为工具，供 LLM 客户端调用。
• 多客户端支持: 提供安装脚本，方便与 Claude、Windsurf 和 Goose 等 MCP 客户端集成。

安装步骤

1. 安装 Node.js 和 npm: 确保你的系统上已安装 Node.js 和 npm。
2. 安装 forevervm-mcp: 运行命令 'npm install -g forevervm-mcp' 全局安装 ForeverVM MCP 服务器。
3. 配置 ForeverVM 令牌: 确保你已配置 ForeverVM API 令牌。如果没有，请运行 'npx forevervm login' 或 'npx forevervm signup' 进行设置。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令和参数才能连接到 ForeverVM MCP 服务器。以下是一个典型的配置示例，你需要将其配置到你的 MCP 客户端中。

{
  "serverName": "forevervm",  // MCP 服务器的名称，可以自定义
  "command": "npx",          // 启动 MCP 服务器的命令，这里使用 npx 来运行 forevervm-mcp 包
  "args": ["--yes", "forevervm-mcp", "run"] // 传递给启动命令的参数，--yes 用于跳过安装过程中的提示 (如果需要), forevervm-mcp 是包名, run 子命令指示运行 MCP 服务器
}

基本使用方法

1. 启动 MCP 服务器: 在终端运行 'forevervm-mcp run' 启动服务器。
2. 配置 MCP 客户端: 在你的 MCP 客户端（如 Claude、Windsurf、Goose）中，配置 MCP 服务器连接信息，使用上面提供的 JSON 配置。
3. 在 LLM 中使用工具: 在 LLM 客户端中，你可以调用 'create-python-repl' 工具创建 Python REPL 会话，并使用 'run-python-in-repl' 工具在指定的 REPL 中执行 Python 代码。