Sandbox Fusion

🚀 砂箱融合 MCP 服务器

这是一个对接 Sandbox Fusion 的 MCP（机器代码协议）服务器实现，能为大语言模型赋予代码解释器功能，助力模型更好地处理和执行代码。

🚀 快速开始

本砂箱融合 MCP 服务器可快速为大语言模型提供代码解释器功能。你可按以下步骤进行安装和运行。

✨ 主要特性

• 🌐 支持多种编程语言的代码执行，涵盖 Python、JavaScript/TypeScript 等。
• 📓 支持 Jupyter 笔记本执行，方便数据科学和交互式编程。
• 💬 通过 stdio 交互方式与客户端通信，实现高效数据传输。
• 🛠️ 提供资源和工具 API 供大语言模型调用，拓展模型功能。

📦 安装指南

环境要求

• Python 3.10+
• Conda（推荐用于环境管理）

安装步骤

1. 克隆仓库

git clone https://github.com/happyZYM/sandbox-fusion-mcp.git
cd sandbox-fusion-mcp

2. 创建并激活 Conda 环境

conda env create -f environment.yml
conda activate mcp-sandbox-fusion

📚 详细文档

配置

服务器通过环境变量进行配置：

• SANDBOX_FUSION_ENDPOINT：Sandbox Fusion API 的端点地址，默认为 http://localhost:8000

运行

使用提供的启动脚本运行服务器：

./launch.sh

或者直接运行 Python 脚本：

python server.py

💻 使用示例

与客户端集成

MCP 服务器使用 stdio 交互方式与客户端通信，客户端可以通过 JSON - RPC 进行通信。 示例：列出可用工具

{"jsonrpc": "2.0", "method": "list_tools", "params": {}, "id": 1}

📄 API 文档

资源 (Resources)

服务器提供以下资源：

1. sandbox://languages - 获取支持的编程语言列表
2. sandbox://endpoint - 获取当前配置的 Sandbox Fusion 端点信息

工具 (Tools)

服务器提供以下工具：

1. execute_code - 执行代码片段
   • 参数：
     • code (字符串)：要执行的代码
     • language (字符串，可选)：编程语言，默认为 "python"
     • timeout (整数，可选)：执行超时时间（秒）
2. execute_jupyter - 执行 Jupyter 笔记本
   • 参数：
     • notebook_content (字符串)：Jupyter 笔记本内容（JSON 格式）
     • timeout (整数，可选)：执行超时时间（秒）

提示模板 (Prompts)

服务器提供以下提示模板：

1. code_execution_prompt - 代码执行提示模板
   • 参数：
     • language (字符串，可选)：编程语言，默认为 "python"
     • description (字符串，可选)：代码任务描述
2. jupyter_execution_prompt - Jupyter 笔记本执行提示模板
   • 参数：
     • description (字符串，可选)：笔记本任务描述

🔧 技术细节

代码结构

项目目录如下：

sandbox-fusion-mcp/
├── server.py          # 主程序入口
├── launch.sh         # 启动脚本
└── environment.yml   # Conda 环境配置文件

贡献指南

如果要为该项目做贡献，请遵循以下步骤：

1. Fork 项目仓库
2. 创建功能分支
3. 提交代码
4. Push 到远程仓库
5. 创建 Pull Request

🚑 故障排除

如果在安装或运行过程中遇到问题，请检查以下事项：

• 确保已正确安装 Python 和 Conda
• 检查环境变量是否配置正确
• 查看日志文件以获取更多信息

⚠️ 注意事项

⚠️ 重要提示

• 请勿在生产环境中直接使用未经测试的版本
• 修改配置前请备份重要数据
• 确保 API 调用的安全性

📄 许可证

该项目遵循 MIT 许可证，具体内容如下：

MIT License

Copyright (c) [年份] [作者姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.