文心快码配置MCP服务器和使用教程

AI教程 2025-04-28 7
文心快码

文心快码

  • AI编程
  • 10
  • 12.10453.baidu-comate

MCP(模型上下文协议)是一个开放协议,它允许大型语言模型(LLMs)访问自定义的工具和服务。文心快码 作为MCP客户端,可以选择向MCP Server发起请求,以使用它们提供的工具、读取数据源等,从而扩展 Zulu智能体 的功能。您可以自行添加 MCP Server来使用。更多信息,请参阅MCP官方文档

1. 配置MCP

1.1 配置入口

根据您的使用情况,您可以将此配置放在两个位置:

项目级MCP配置

  • 什么是项目级MCP:对于特定于项目的工具,这允许您定义仅在该特定项目中可用的 MCP 服务器。

  • 入口:要使用 文心快码 的MCP功能,请前往「Zulu」,在会话框中找到配置MCP的入口:


全局个人配置

敬请期待

1.2 配置MCP 服务器

MCP 配置文件采用 JSON 格式,结构如下:

  • Node.js服务器,使用npx运行

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }}
  • Python服务器,使用python运行

{
  "mcpServers": {
    "server-name": {
      "command": "python",
      "args": ["mcp-server.py"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}
  • 通过网络通信,可与他人跨机器远程共享

{
  "mcpServers": {
    "server-name": {
      "url": "http://localhost:3000/sse",
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

(此env字段允许您制定MCP服务器进程可用的环境变量。可再此管理 API 密钥和其他敏感信息的配置)

  • sequential-thinking为例,配置内容如下:

{
    "mcpServers": {
        "sequential-thinking": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-sequential-thinking"
            ]
        }
  }
}

如果您不知道有哪些公开的MCP Servers,可阅读此文档查看更多MCP Server

1.3 支持的传输类型

文心快码 支持两种 MCP 服务器的传输类型:

Stdio传输SSE传输
- 在本地机器上运行
- 通过以下方式直接沟通stdout
- 仅您本地可访问
- 可以在本地或远程运行
- 通过网络进行通信
- 可以跨机器共享

1.4 确认MCP Server是否正常

  • 当您在.json文件中完成配置并进行保存后,请在Zulu的输入框上方点击‘刷新’操作,来确保MCP Server是否正常。

  • 若在重启MCP Server服务器时,出现报错情况,请在Zulu的输入框上方点击'报错'操作,或直接打开输出 > Baidu Comate MCP查看最近的MCP Server输出信息排查报错情况。



2. 对话中允许使用MCP Tool

如果 Zulu 认为您的问题与某个MCP Server相关,它将自动使用 MCP 中提供的 工具。如果您认为本次对话有必要使用某个工具,只需告知Zulu使用该工具名称或描述即可。

  • 默认情况下,当 Zulu 想要使用 MCP 工具时,它会显示一条消息请求您的批准。

  • 当您同意 Zulu 使用后,将自动完成MCP工具的使用,并将结果作为上下文继续生成后面的内容。

  • 您可以使用工具名称旁边的箭头展开该消息,查看 Zulu 调用该工具时使用的参数、返回的结果信息。

3. 使用须知

为了帮助您更好地使用MCP功能,我们温馨提醒您关注以下使用要点(相关功能正在持续优化中):

3.1 使用条件

目前MCP仅支持Zulu模式下使用,建议您提前确认账户剩余的Zulu可用次数,以确保流程顺利进行。

3.2 工具稳定性说明

由于MCP工具的调用逻辑由AI模型自主决策,且可能涉及不同开发者编写的服务端代码,存在以下需要您理解的情况:

  • 工具调用具有不确定性,可能出现未触发调用或调用未成功的情况。

  • 每次调用尝试(无论结果如何)都将消耗1次Zulu使用权限。

  • 我们建议您在关键流程中做好备用方案,以确保服务连续性。

3.3 文件配置规范

为保障MCP Server稳定运行,请特别注意:

  • 项目路径.comate/mcp.json的配置文件需控制总行数在5000行以内。

  • 超过行数限制可能导致服务加载异常,建议定期优化文件结构。

文章由本站整理发布,转载请注明地址:https://www.12330.com.cn/view-7c7754ce

文章目录