MCP工具动态加载器

Limbo是一个元MCP服务器,允许AI助手动态安装和管理自己的工具,无需重启或手动配置。

  • by Pritz395
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Pritz395/l1mbo

使用说明

边缘网关 - 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协议开源。

  1. 为仓库创建分支
  2. 创建一个特性分支
  3. 进行你的更改
  4. 提交拉取请求

链接

  • 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.