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。