MCP 配置指南

MCP（Model Context Protocol）协议让 AI 能够安全地调用外部服务和 API。本指南将详细介绍如何在 OPENUGC 中配置和使用 MCP 服务。

什么是 MCP？

MCP 是一种标准协议，允许 AI 模型与外部服务进行安全、标准化的通信。通过 MCP，您的 AI 助手可以：

访问实时数据（天气、股票、新闻等）
调用外部工具和服务
执行复杂的自动化任务
扩展 AI 的能力边界

MCP 服务配置

步骤 1：进入 MCP 服务页面

在侧边栏导航中，点击【MCP服务】进入服务管理页面。

步骤 2：添加新服务

点击左侧 MCP 列表顶部的【添加服务】按钮。

MCP配置界面 MCP 配置界面 - 连接外部 AI 服务

步骤 3：填写服务信息

在弹出的对话框中，填写以下信息：

基本信息

服务名称：为您的 MCP 服务起一个有意义的名称
备注信息：描述服务用途或特殊说明

技术配置

MCP 类型：选择服务类型
- SSE：服务器发送事件，适用于实时数据流
- StreamableHTTP：可流式传输的 HTTP 协议
MCP 地址：输入 MCP 服务的完整 URL
自定义头信息：以 JSON 格式提供（可选）
json
```
{
  "Authorization": "Bearer your-token-here"
}
```
代理中转开关：根据需要开启
- 关闭：尝试直连 MCP 服务链接
- 开启：使用代理中转访问 MCP 服务
- 当自定义了 Authorization 等认证信息，可能因跨域问题无法链接到 MCP 服务时，可以使用中转顺利链接
- 确保代理服务稳定可用

步骤 4：启用服务

添加完毕后，点击进入对应服务的详情界面：

右上角有【启用】/【停用】服务开关
打开开关后，系统自动：
- 连接 MCP 服务
- 加载支持的工具列表
- 在内容区域下方显示工具信息

步骤 5：查看工具列表

启用服务后，您可以查看：

可用工具列表：显示所有可调用的工具
工具说明：每个工具的功能描述
参数信息：工具所需的输入参数
使用示例：推荐的使用方式

工具列表信息示例

以天气查询服务为例：

工具名称：get_weather
功能描述：根据城市名称获取天气信息
参数：
  - city（必填）：城市名称，如"北京"
  - days（可选）：查询天数，默认1天

使用示例：
  输入：city="北京", days=1
  返回：北京市今天天气：晴，气温15-25°C

又如股票查询服务：

工具名称：get_stock_price
功能描述：获取指定股票代码的当前价格
参数：
  - symbol（必填）：股票代码，如"AAPL"

使用示例：
  输入：symbol="AAPL"
  返回：AAPL当前价格：$178.45

在对话中使用 MCP

启用 MCP 服务

在对话输入框中
选择 MCP 服务按钮
从下拉列表中选择已启用的服务

调用工具示例

示例 1：查询天气

用户：调用工具查询今天的天气
AI：已通过天气查询服务获取数据，今天天气...

温度：18-25°C
天气：多云
湿度：65%

示例 2：股票查询

用户：帮我调用股票查询工具，查一下苹果公司的股价
AI：已通过股票查询服务获取数据：

AAPL (Apple Inc.)
当前价格：$178.45
涨跌：+2.35 (+1.33%)

示例 3：新闻查询

用户：请调用新闻工具，获取最新的科技资讯
AI：已通过新闻查询服务获取最新资讯：

1. OpenAI 发布新的 GPT 模型...
2. Google 推出 AI 编程助手...
3. 微软强化 AI 集成...

高级使用技巧

1. 安全配置

自定义头信息

使用 API Key 进行身份验证
添加必要的认证信息
添加自定义元数据

代理中转使用场景

当自定义了 Authorization 等认证信息，可能因跨域问题无法链接到 MCP 服务时，使用中转能够顺利链接
开发环境（避免 CORS 问题）
企业内网服务

2. 工具调用最佳实践

明确指令

✅ 推荐："调用工具查询明天的天气"
❌ 不推荐："明天天气怎么样？"

组合使用

同时使用多个 MCP 服务
在对话中切换不同服务
结合上下文进行复杂查询

常见问题

Q: 为什么我的 MCP 服务无法连接？ A: 检查以下几点：

MCP 地址是否正确且可访问
是否需要开启代理中转
自定义头信息是否包含必要的认证
服务是否支持对应的 MCP 类型

Q: 可以同时启用多个 MCP 服务吗？ A: 可以！您可以添加多个 MCP 服务，但在对话中一次只能选择一个服务进行调用。

Q: 工具列表为空怎么办？ A: 可能的原因：

服务连接失败，检查网络和地址
服务端工具加载异常，联系服务提供商
权限不足，检查认证信息

Q: 代理中转会影响性能吗？ A: 会轻微影响，但能解决跨域问题。生产环境建议配置支持 CORS 的 MCP 服务。

Q: 如何知道 MCP 服务支持哪些工具？ A: 启用服务后，工具列表会自动加载并显示在服务详情页面。

Q: 自定义头信息格式错误？ A: 确保是有效的 JSON 格式，例如：

json

{
  "Authorization": "Bearer your-token",
  "X-API-Key": "your-key"
}

注意事项

服务稳定性：建议使用稳定可靠的 MCP 服务
数据安全：不要在自定义头中暴露敏感信息
费用控制：注意外部服务的调用费用
错误处理：关注服务状态，及时处理错误

MCP 配置指南 ​

什么是 MCP？ ​

MCP 服务配置 ​

步骤 1：进入 MCP 服务页面 ​

步骤 2：添加新服务 ​

步骤 3：填写服务信息 ​

步骤 4：启用服务 ​

步骤 5：查看工具列表 ​

工具列表信息示例 ​

在对话中使用 MCP ​

启用 MCP 服务 ​

调用工具示例 ​

高级使用技巧 ​

1. 安全配置 ​

2. 工具调用最佳实践 ​

常见问题 ​

注意事项 ​

相关文档 ​