Mcp Code Executor Server

MCP Code Executor Server

一款功能强大的 Model Context Protocol（MCP） 服务，可让 AI Agent 在安全、隔离的环境中使用多种编程语言执行代码。

---

🚀 概述

MCP Code Executor Server 通过提供统一的 MCP 工具端点，规范了 AI 模型连接各种编程运行时的方式。它允许 AI 助手：

1. 提交受支持语言的代码。
2. 在受控的沙箱环境中执行代码。
3. 接收输出，包括编译错误或运行时错误。

---

🔑 主要功能

• 多语言支持：Java、Python、JavaScript、TypeScript 和 C++。
• 安全执行：使用资源限制（CPU、内存、超时时间）的隔离容器。
• MCP 集成：符合 MCP 规范的服务，便于客户端发现。
• 自动编译：为 Java、C++ 和 TypeScript 处理编译并运行。
• 详细的错误反馈：返回编译时和运行时错误消息。
• 资源清理：自动删除临时文件，并强制执行超时时间。

---

📐 架构

MCP Code Executor Server 采用客户端-服务端模型：

• MCP 客户端：连接到此服务的协议客户端。
• MCP 服务：此应用，提供代码执行工具。
• 沙箱运行时：为每个请求创建的容器或隔离进程。

---

🏁 快速开始

前置条件

• Java 17+
• Python 3.8+
• Node.js 和 npm
• g++ 或其他 C++ 编译器

本地设置

1. 克隆仓库：

   git clone https://github.com/yourusername/mcp-code-executor-server.git
   cd mcp-code-executor-server
   

2. 构建并运行：

   # Build the project
   ./mvnw clean package
   
   # Start the server
   ./mvnw spring-boot:run
   

服务默认监听端口 8080。

使用 Docker

为实现隔离，请在 Docker 中运行：

# Build Docker image
docker build -t mcp-code-executor .

# Run container
docker run -p 8080:8080 mcp-code-executor

或使用 Docker Compose：

docker-compose up -d

---

🛠️ 连接 MCP 客户端

1. 启动兼容 MCP 的 AI 客户端。
2. 将其指向 http://localhost:8080。
3. 发现并调用 code-execution 工具。

MCP 请求示例：

{
  "language": "python",
  "code": "print('Hello, world!')\nprint('hello again')"
}

---

🤝 参与贡献

欢迎贡献！

---

📄 许可证

Apache License 2.0。详情请参阅 LICENSE 文件。