跳到主要内容

配置MCP服务

信息

观看此章节之前，请前往官方了解 MCP 协议内容，并获取所需要的服务。

开发可以参考：
官方文档 Time MCP Server 推荐使用教程中的方式构建 MCP 服务。使用 Python 请使用官方包。

配置本地 MCP 服务​

注意

本地 MCP 服务有以下两个特点： 1、会安装到本地电脑上，登录不同用户会共用此 MCP 配置。 2、无法进行步骤编辑，如果要共享，请优先使用控制台 MCP 服务。

1. 获取 MCP 服务器地址​

在配置 bit-Agent 之前，需要先下载并部署 MCP 服务器。

你可以参考 MCP 官方示例 来选择合适的服务，例如：

  • filesystem：提供对本地文件系统的访问能力；

  • sqlite：通过 MCP 接口访问 SQLite 数据库；

  • web-api：将 REST API 暴露为 MCP 服务；

  • custom：自定义能力服务。

2. 在 bit-Agent 中配置 MCP 服务器​

  1. 打开 bit-Agent 应用
  2. 点击右上角的"设置"图标
  3. 在设置菜单中选择"服务配置"
  4. 在"MCP 服务器"部分，按照 MCP 服务协议规定写入内容，以下是一个示例，配置了官方提供的 filesystem 和 sqlite 服务，其中的路径按照信息按照协议填写：
{
  "mcpServers": {
    "filesystem": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "D:\\agent\\data"
      ]
    },
    "sqlite": {
      "command": "cmd",
      "args": [
        "/c",
        "uvx",
        "--directory",
        "D:\\agent\\servers-main\\src\\sqlite",
        "mcp-server-sqlite",
        "--db-path",
        "D:\\agent\\data\\test.db"
      ]
    }
  }
}

  1. 配置完成后，点击“保存配置”，软件会自动启动对应服务。成功启动的服务显示状态为“正常”，否则会显示为“异常”。异常状态的服务不可用。
  2. 点击工具，可以查看服务包含的工具。
  3. 设置中可以配置服务可用的模式，默认在探索模式和通用模式均可以使用。

什么是 MCP​

MCP (Model Control Protocol) 是一个基于开放协议的标准化服务组件，用于为大型语言模型（LLM）提供安全、可扩展的外部工具与数据访问能力。
通过 MCP 协议，AI 应用（例如智能 Agent、IDE 插件或企业 AI 平台）可以以标准方式与多个外部服务通信，从而访问以下类型资源：

  • 本地文件系统（如读取/写入文件）

  • 数据库（如 SQLite、PostgreSQL）

  • 远程 API 服务（如第三方业务系统）

  • 企业内部服务（如知识库、权限系统等）

通过 MCP，AI 模型不仅可以“理解和推理”，还可以安全地执行实际操作（如查询数据库、修改配置、分析日志文件等），从而扩展模型的感知与执行边界。

MCP 的工作原理简述​

MCP 协议定义了模型与外部服务之间的通信标准。
它通常包含以下三个主要角色：

  1. MCP Server：提供某种能力或资源访问的服务（如文件系统、数据库、Web API 接口等）。

  2. MCP Client：发起请求的 AI 应用（如 bit-Agent、IDE 插件、LLM 推理框架）。

  3. MCP Stream：模型与服务之间的通信通道，通常基于 WebSocket 或 Streamable HTTP。

交互过程如下：

  • Client 发送请求（例如“读取文件内容”、“执行 SQL 查询”）；

  • Server 接收并执行对应任务；

  • Server 返回结构化响应；

  • 模型根据响应内容继续决策或生成输出。