Skip to content

MCP 集成

MCP(Model Context Protocol)是扩展智能体能力的重要方式。系统支持通过管理界面动态配置 MCP 服务器,无需修改代码。

内置 MCP 服务器以代码为事实源:系统启动时会自动补齐缺失项,并用代码中的最新连接与展示字段覆盖数据库定义;是否“已添加”以及工具级禁用列表仍保留数据库状态。

支持的传输协议

协议说明适用场景
Streamable HTTP流式 HTTP 连接远程 MCP 服务
SSEServer-Sent Events标准 HTTP 长连接
Stdio标准输入输出本地进程

配置示例

远程 MCP 服务

json
{
    "name": "custom-remote-mcp",
    "transport": "streamable_http",
    "url": "https://example.com/mcp"
}

本地 Python 进程

json
{
    "name": "mysql-mcp-server",
    "transport": "stdio",
    "command": "uvx",
    "args": ["mysql_mcp_server"],
    "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_DATABASE": "your_database"
    }
}

服务器管理

管理界面使用“添加 / 移除”语义管理 MCP 服务器:

  • 已添加:enabled=true,运行时按服务器 slug 直接读取数据库中的最新配置并建立连接
  • 可添加:enabled=false,记录保留但不会进入运行时

Agent 配置中的 mcps 决定本次运行可使用哪些已添加服务器;未显式配置时使用当前用户可见的全部服务器。工具对象会按配置哈希做本地缓存,更新服务器配置后会自动使用新的缓存键,不需要重启服务。

工具管理

MCP 工具支持粒度控制:管理员可以单独启用或禁用某个 MCP 服务器下的特定工具,实现精细化的权限管理。

本项目基于 MIT License 开源,欢迎使用和贡献。