🦙 ollama-mcpo-adapter

将 MCPO (MCP 到 OpenAPI 的代理服务器) 工具作为 Ollama 兼容的函数公开，使用一个简单的 Python 适配器和可选的运行时服务。

---

✨ 特性

• 🔌 连接到 MCPO 实例
• ⚙️ 通过 MCPOService 以编程方式启动您自己的 MCPO 服务器
• 🔁 将通过 OpenAPI 公开的 MCP 工具 列为 Ollama 兼容的工具函数

---

🚀 快速开始

1. 安装

pip install ollama-mcpo-adapter

使用现有 MCPO 实例

假设您像这样运行 MCPO：

uvx mcpo --port 5090 --config /path/to/mcp_config.json

您可以使用适配器以 Ollama ToolCall 格式获取所有可用函数：

from ollama_mcpo_adapter import OllamaMCPOAdapter

adapter = OllamaMCPOAdapter(host="localhost", port=5090, config_path="/path/to/mcp_config.json")
# 从 MCPO FastAPI /docs 获取工具描述
tools = adapter.list_tools_ollama()

您可以省略配置路径。 但是，提供配置可以更可靠地发现 MCP 服务器名称。 否则，服务器名称将从自动生成的 OpenAPI 文档 MCPO 提供的内容中读取，这些内容将来可能会更改。

---

使用本地 MCPO 服务

您可以使用此扩展启动 MCPO 服务：

from ollama_mcpo_adapter import MCPOService

# 将您的 mcp 配置作为 JSON 文件或字典提供
mcp_config = {
    "mcpServers": {
        "time": {"command": "uvx", "args": ["mcp-server-time", "--local-timezone=Europe/Berlin"]}
    }
}
mcpo = MCPOService("127.0.0.1", 4090, config=mcp_config,
                   # -OR- 从现有的 mcp_config 文件
                   config_path="path/to/mcp_config.json")
# MCPOSService 类处理 MCPO 服务器的启动和关闭，并在子进程中运行
mcpo.start(wait=True)
...
mcpo.stop()

然后使用适配器获取所有可用工具：

from ollama_mcpo_adapter import OllamaMCPOAdapter
adapter = OllamaMCPOAdapter("127.0.0.1", 4090)
tools = adapter.list_tools_ollama()

将其发送到 Ollama：

from ollama import Client
# 使用发现的工具向 Ollama 发送提示
client = Client(host="http://127.0.0.1:11434")
response = client.chat(
    model="qwen2.5-coder:14b-instruct-q4_K_M",
    messages=[{"role": "user", "content": "Write a file..."}],
    tools=tools,
)

最后调用这些工具：

# 处理任何工具调用
if response.message.tool_calls:
    adapter.call_tools_from_response(response.message.tool_calls)

---

环境变量

• MS Windows npx 路径，您可以使用配置解析器中的 npx 路径覆盖 npx

  示例：WIN_NODEJS_NPX_PATH=C:\Program Files\nodejs\npx.cmd

---

🧪 运行测试

pytest

---

📂 项目结构

ollama_mcpo_adapter/
├── adapter.py        # 工具发现 + Ollama 集成
├── service.py        # 可选：以编程方式启动 MCPO
├── service_runner.py # MCPO 子进程控制
├── config_parser.py  # MCP 配置解析助手
├── dispatcher.py     # 分发工具调用

---

📜 许可证

MIT。 参见 LICENSE。