Sandbox Fusion

🚀 砂箱融合 MCP 服務器

這是一個對接 Sandbox Fusion 的 MCP（機器代碼協議）服務器實現，能夠為大語言模型賦予代碼解釋器功能，助力模型更好地處理和執行代碼。

🚀 快速開始

本服務器可讓大語言模型具備代碼解釋器功能。要使用該服務器，需完成安裝、配置，然後啟動服務，即可通過 API 調用其功能。

✨ 主要特性

• 支持 Python、JavaScript/TypeScript、Bash 等多種編程語言的代碼執行。
• 支持 Jupyter 筆記本執行，方便進行交互式代碼開發。
• 通過 stdio 交互方式與客戶端通信，客戶端可藉助 JSON - RPC 進行通信。
• 提供資源和工具 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

💻 使用示例

基礎用法

列出可用工具：

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

📚 詳細文檔

配置

服務器通過環境變量進行配置：

• SANDBOX_FUSION_ENDPOINT：Sandbox Fusion API 的端點地址，默認為 http://localhost:8000

運行

使用提供的啟動腳本運行服務器：

./launch.sh

或者直接運行 Python 腳本：

python server.py

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（字符串，可選）：筆記本任務描述

與客戶端集成

MCP 服務器使用 stdio 交互方式與客戶端通信，客戶端可以通過 JSON - RPC 進行通信。

故障排除

如果在安裝或運行過程中遇到問題，請檢查以下事項：

• 確保已正確安裝 Python 和 Conda
• 檢查環境變量是否配置正確
• 查看日誌文件以獲取更多信息

開發指南

代碼結構

項目目錄如下：

sandbox-fusion-mcp/
├── server.py          # 主程序入口
├── launch.sh         # 啟動腳本
└── environment.yml   # Conda 環境配置文件

貢獻指南

如果要為該項目做貢獻，請遵循以下步驟：

1. Fork 項目倉庫
2. 創建功能分支
3. 提交代碼
4. Push 到遠程倉庫
5. 創建 Pull Request

注意事項

⚠️ 重要提示

• 請勿在生產環境中直接使用未經測試的版本。
• 修改配置前請備份重要數據。
• 確保 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.