MCP工具集成服务

通过mcpo配置代理将MCP工具(预制和自定义)与OpenWebUI集成,实现工具调用和管理。

  • by cycloarcane
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 cycloarcane/mcp-testing

使用说明

MCP测试:OpenWebUI+mcpo集成

此仓库用于通过以下方式尝试运行MCP工具(预制和定制) mcpo 并将它们与OpenWebUI干净地集成在一起。


✨ 当前目标

设置并成功呼叫 一个预制MCP工具 (mcp-server-time)使用 mcpo的基于配置的代理和OpenWebUI。


🔧 运行代理

使用此命令启动 mcpo 使用您的工具配置:

uvx mcpo --port 8000 --api-key dev123 --config ./config.json

这将为您的工具提供服务 http://127.0.0.1:8000,每个工具都安装在其钥匙下(例如。 /time).


📊 配置文件示例(单个工具)

config.json:

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone=America/New_York"]
    }
  }
}

🌐 OpenWebUI 设置

正确端点:

基本URL:

http://127.0.0.1:8000/time

OpenAPI 网址:

/openapi.json

❌ 不要这样做:

  • http://127.0.0.1:8000 作为基本URL(此操作失败)
  • /time/openapi.json 作为OpenAPI URL(此操作失败)

🏁 工具调用清单

  1. mcpo已成功启动配置
  2. 工具出现在OpenWebUI中的可用工具下
  3. 聊天工具切换已启用(右侧边栏或聊天输入的左下角)
  4. 聊天模式支持函数调用(如GPT-4、Mistral-7B-func、Qwen3)
  5. 使用正确的路径调用工具: /time/get_current_time

🔄 故障排除

  • 401未经授权: 确保您使用 Authorization: Bearer dev123 头或将密钥输入到OpenWebUI的API密钥字段中。
  • 404未找到: 仔细检查刀具安装路径。工具功能如下 /tool-name/function-name 在配置模式下。
  • 工具没有响应: OpenWebUI中的基本URL错误(可能仍指向根)。

📓 发展路线图

  • [x] 使用配置的单个预制工具
  • []使用配置的多个预制工具
  • []使用配置的单个自定义工具
  • []使用配置混合使用自定义和预制工具

快乐的黑客✨