自托管LLM工具创建平台

MCPbox是一个自托管平台,允许LLM创建自己的工具,通过编写Python代码并在沙盒中运行,需管理员批准后永久生效。

  • by JGtHb
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 JGtHb/MCPbox

使用说明

MCPbox

一个自托管平台,您的LLM可以在其中创建自己的工具。当它需要一个尚不存在的功能时,它会编写Python代码,你批准它,它就会成为一个在沙盒中运行的永久MCP工具。在每个工具、库和网络请求上线之前,可以选择批准。

[!警告] 积极开发 --预计会有突破性的变化、不完整的功能和粗糙的边缘。如果需要稳定性,请固定到特定的释放。

[!小心] 人工智能生成的代码库 --这个存储库完全由Claude编写(Opus 4.6)。它包括测试、安全审查和CI,但在运行代码之前要自己审查代码,尤其是沙箱执行和身份验证组件。


运作原理

MCPbox暴露28 mcpbox_* MCP上的管理工具。LLM使用它们来创建服务器、编写工具代码、请求批准和管理生命周期。管理员在工具上线之前通过web UI批准工具。

例如,你问“克劳德现在有问题吗?”但目前还没有相应的工具:

1. mcpbox_create_server   → "uptime" server created
2. mcpbox_create_tool     → claude_status tool (Python: fetch Anthropic status page)
3. mcpbox_test_code       → test passes, returns JSON
4. mcpbox_request_publish → submitted for admin approval

管理员在web UI中批准。

5. mcpbox_start_server    → server is live
6. claude_status          → calls the tool it just built

工具仍然存在。下次,LLM会打电话 claude_status 直接。


特性

  • 通过MCP创建工具 --LLM编写Python,它成为一个永久的MCP工具
  • 外部MCP源 --通过MCPbox代理现有的MCP服务器
  • 审批工作流程 --工具从草稿开始,管理员在发布前审查代码并批准
  • 沙盒执行 --受限内置、导入白名单、网络控制、SSRF防护、256MB/60s限制
  • 加密的秘密 --每台服务器AES-256-GCM;LLM创建占位符,管理员设置值
  • 执行日志记录 --每次调用的输入、输出、持续时间和错误
  • 自托管 --单身 docker compose up,在任何家庭实验室或VPS上运行
  • 远程访问 --可选的Cloudflare隧道与OAuth 2.1(适用于claude.ai、ChatGPT、Cursor等)

快速开始

git clone https://github.com/JGtHb/MCPbox.git
cd MCPbox

cp .env.example .env

# Generate required secrets
echo "MCPBOX_ENCRYPTION_KEY=$(openssl rand -hex 32)" >> .env
echo "POSTGRES_PASSWORD=$(openssl rand -hex 16)" >> .env
echo "SANDBOX_API_KEY=$(openssl rand -hex 32)" >> .env

# Run migrations, then start
docker compose run --rm backend alembic upgrade head
docker compose up -d

打开http://localhost:3000创建您的管理员帐户。

连接MCP客户端

添加到您的MCP客户端配置(Claude Code、Cursor等):

{
  "mcpServers": {
    "mcpbox": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

28 mcpbox_* 管理工具是自动发现的。

有关网络外部的远程访问,请参阅 远程访问设置.

文档

完整文档

文档 描述
安装 设置和要求
快速开始 首次设置和UI教程
创建你的第一个工具 端到端工具创建演练
MCP工具参考 全部28 mcpbox_* 工具
远程访问 Cloudflare隧道设置
开发人员文档 架构、安全、API合同

许可证

PolyForm非商业许可证1.0.0。个人/非商业用途免费。商业用途需要单独的许可证。

安全

发现漏洞?打开A GitHub安全咨询 而不是公共问题。