🦙 ollama-mcpo-adapter

🦙 ollama-mcpo-adapter

シンプルな Python アダプターとオプションのランタイムサービスを使用して、MCPO（MCP-to-OpenAPI プロキシサーバー）のツールを Ollama 互換の関数として公開します。

---

✨ 特長

• 🔌 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")
# Gets tool descriptions from MCPO FastAPI /docs
tools = adapter.list_tools_ollama()

設定ファイルのパスは省略できます。ただし、設定ファイルを指定すると、MCP サーバー名をより確実に検出できます。 指定しない場合、サーバー名は MCPO が提供する自動生成された OpenAPI ドキュメントから読み取られます。この仕様は将来変更される可能性があります：MCPO。

---

ローカルの MCPO サービスを使用する

この拡張機能を使って MCPO サービスを起動できます：

from ollama_mcpo_adapter import MCPOService

# Provide your mcp config as JSON file or dictionary
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- from an existing mcp_config file 
                   config_path="path/to/mcp_config.json")
# MCPOSService class handles MCPO server start-up and shutdown and in a subprocess
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
# Send a prompt to Ollama using discovered tools
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,
)

最後に、ツールを呼び出します：

# Handle any tool calls
if response.message.tool_calls:
    adapter.call_tools_from_response(response.message.tool_calls)

---

環境変数

• MS Windows の npx パス。設定パーサーで npx のパスを上書きできます。

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

---

🧪 テストの実行

pytest

---

📂 プロジェクト構成

ollama_mcpo_adapter/
├── adapter.py        # Tool discovery + Ollama integration
├── service.py        # Optional: launch MCPO programmatically
├── service_runner.py # MCPO subprocess control
├── config_parser.py  # MCP config parsing helpers
├── dispatcher.py     # Dispatch tool calls

---

📜 ライセンス

MIT。詳細は LICENSE をご覧ください。