使用说明
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安全咨询 而不是公共问题。
