Ollama Mcpo Adapter

🚀 🦙 Ollama-MCP适配器

本项目通过简单的 Python 适配器和可选运行时服务，将 MCPO（MCP 到 OpenAPI 的代理服务器）工具以 Ollama 兼容函数的形式暴露，为开发者提供便利。

🚀 快速开始

安装

pip install ollama-mcpo-adapter

使用现有 MCPO 实例

假设你已经运行了类似以下的 MCPO：

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

你可以使用适配器获取所有可用函数：

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 服务器名称更为可靠。否则，MCPO 自动生成的 OpenAPI 文档中的服务器名称可能会发生变化。

使用本地 MCPO 服务

你可以使用此扩展启动一个 MCPO 服务：

from ollama_mcpo_adapter import MCPOService

# 提供 MCP 配置文件或字典
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_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": "写一个文件..."}],
    tools=tools,
)

最后调用工具：

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

环境变量

• Windows 的 npx 路径，你可以通过配置解析器覆盖，默认路径为 WIN_NODEJS_NPX_PATH=C:\Program Files\nodejs\npx.cmd

🧪 运行测试

pytest

✨ 主要特性

• 🔌 连接到一个 MCPO 实例
• ⚙️ 通过 MCPOService 程序启动自己的 MCPO 服务器
• 🔁 列出通过 OpenAPI 暴露的 MCP 工具（工具）作为 Ollama 兼容工具函数

📚 详细文档

📂 项目结构

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

📄 许可证

本项目采用 MIT 许可证。查看 LICENSE。