使用说明
边缘网关 - MCP 集线器
为您的AI助手增加额外功能。按需动态加载MCP工具。
Limbo是一个元MCP(元计算平台)服务器,它允许AI助手动态安装和管理自己的工具。无需重启,无需手动配置——只需提问即可。
问题
设置模型上下文协议(MCP)工具非常繁琐:
- 手动编辑配置文件
- 重启所有内容以应用更改
- 管理10多个服务器配置
- 反复调试连接问题
这就像要求你的AI在使用每一个所需工具时都要先申请许可。
💡 解决方案
Limbo 将多个 MCP 服务器聚合到一个统一的界面中,使您的 AI 能够动态地:
- ✅ 按需安装新工具
- ✅ 移除未使用的工具
- ✅ 自动管理配置
- ✅ 无需人工干预即可扩展
思考:一个包管理器,但专注于AI能力。
快速入门
Docker(推荐)
# Pull and run
docker pull pr33th4m/l1mbo:latest
docker run -p 8000:8000 pr33th4m/l1mbo:latest
# With persistent config
docker run -p 8000:8000 -v limbo-config:/home/limbo/.limbo pr33th4m/l1mbo:latest
本地安装
# Clone repository
git clone https://github.com/Pritz395/limbo.git
cd limbo
# Install with uv (recommended)
uv sync
limbo serve --http
# Or with pip
pip install -e .
limbo serve --http
使用方法
Stdio 模式(适用于 Claude 桌面版、Cursor 等)
limbo serve
HTTP 模式(用于系统范围访问)
limbo serve --http --port 8000
混合模式(同时使用stdio + HTTP)
limbo serve --hybrid
示例工作流程
无边缘(或无间隙)状态
You: "I need filesystem access"
AI: "Please configure the filesystem tool, restart me, and try again."
You: *manually configures, restarts*
AI: "Okay, ready now."
与Limbo一起:
You: "I need filesystem access"
AI: *calls limbo_add_server()* → Tool installed
AI: "Done. Which file do you need?"
建筑学
┌─────────────────────────────────────┐
│ Your AI Assistant (Cursor) │
└──────────────┬──────────────────────┘
│
├──→ Docker MCP Gateway
│ ├─ Essential tools (always on)
│ │ ├─ GitHub
│ │ ├─ Obsidian
│ │ └─ Time
│ │
│ └─ Limbo (your "extra limbs")
│ ├─ Calculator (on-demand)
│ ├─ Memory (on-demand)
│ └─ [AI installs more as needed]
管理工具
一旦连接成功,Limbo 提供了16种管理工具:
| 工具 | 用途 |
|---|---|
limbo_add_server |
动态安装MCP服务器 |
limbo_list_servers |
查看所有已配置的服务器 |
limbo_remove_server |
移除服务器 |
limbo_enable_server |
启用已禁用的服务器 |
limbo_disable_server |
暂时禁用服务器 |
limbo_status |
健康检查与统计 |
limbo_search_servers |
在线查找MCP服务器 |
limbo_list_tools |
列出所有可用工具 |
limbo_smart_configure |
从URL自动配置 |
limbo_analyze_servers |
分析并提出改进建议 |
limbo_check |
带修复操作的健康检查 |
limbo_reload_config |
无需重启即可重新加载配置 |
limbo_load_kit |
加载服务器包 |
limbo_unload_kit |
卸载服务器包 |
limbo_list_kits |
列出可用的套件 |
limbo_kit_info |
获取套件信息 |
配置
Limbo 将配置存储在 .limbo/config.json 具备自动热重载功能。
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
LIMBO_CONFIG_PATH |
配置文件位置 | .limbo/config.json |
LIMBO_LOG_LEVEL |
日志级别 | INFO |
LIMBO_AUTO_RELOAD |
启用配置自动重载 | true |
LIMBO_SELF_PREFIX |
工具前缀 | limbo |
LIMBO_READ_ONLY |
只读模式 | false |
示例配置
{
"servers": {
"calculator": {
"command": "npx -y @modelcontextprotocol/server-calculator",
"prefix": "calc",
"enabled": true
},
"filesystem": {
"command": "npx -y @modelcontextprotocol/server-filesystem /workspace",
"prefix": "fs",
"enabled": true
}
}
}
认证
Limbo支持可选的基于JWT的认证:
# Initialize authentication
limbo auth init
# Generate token
limbo auth token
# Use with clients
export LIMBO_JWT=$(limbo auth token -q)
Docker MCP网关集成
将Limbo添加到Docker MCP网关:
# Download catalog
curl -O https://raw.githubusercontent.com/Pritz395/limbo/main/limbo-catalog.yaml
# Add to Docker MCP
docker mcp catalog create custom
docker mcp catalog add custom limbo ./limbo-catalog.yaml
docker mcp server enable limbo
CLI 命令
# Server management
limbo server list # List all servers
limbo server add <name> <command> # Add new server
limbo server remove <name> # Remove server
limbo server enable <name> # Enable server
limbo server disable <name> # Disable server
limbo server info <name> # Server details
# Kit management
limbo kit list # List available kits
limbo kit load <name> # Load a kit
limbo kit info <name> # Kit information
limbo kit export <name> # Export current config as kit
# Authentication
limbo auth init # Setup authentication
limbo auth status # Check auth status
limbo auth token # Generate JWT token
# Configuration
limbo config path # Show config location
用例
发展
在开发过程中,根据需要安装工具,无需切换上下文。
持续集成/持续交付(CI/CD)
根据流水线需求动态配置工具。
多租户
为不同用户提供不同的工具集,而无需进行单独部署。
成本优化
只在需要时运行你实际所需的工具。
特点/功能
- 动态工具加载 - 添加/移除工具而无需重启
- 自动重新加载配置 - 变更立即生效
- 工具前缀(或工具前缀功能) - 避免命名冲突
- 健康监测 - 内置状态检查
- 套件系统 - 捆绑相关工具
- JWT 认证 - 可选的安全层
- Docker 准备就绪 - 准备就绪的生产容器
- 多种运输方式 - 标准输入输出(stdio)、HTTP 或混合模式
路线图
- [ ] 工具市场/发现平台
- [ ] 指标和分析仪表板
- [ ] 支持用于通知的Webhook
- [ ] 自定义工具的插件系统
- [ ] 云部署模板
贡献;助力
欢迎贡献!本项目采用AGPL-3.0协议开源。
- 为仓库创建分支
- 创建一个特性分支
- 进行你的更改
- 提交拉取请求
链接
- Docker Hubhttps://hub.docker.com/r/pr33th4m/l1mbo 的中文翻译可以是:“Docker Hub 上的 pr33th4m/l1mbo 镜像” 或者更简洁地表述为:“Docker 镜像 pr33th4m/l1mbo”。这里,“Docker Hub”是 Docker 的官方镜像仓库网站,“pr33th4m/l1mbo”是该仓库中的一个特定镜像名称
- GitHubhttps://github.com/Pritz395/limbo(可译为:“GitHub上的Pritz395/limbo项目”)
- MCP 文档https://modelcontextprotocol.io/(该网址可直接作为参考,无需翻译)
📧 联系方式
由……建造 普雷塔姆(人名或地名,具体含义需根据上下文确定)
Give your AI the tools it needs, when it needs them.
