Ollama Mcpo Adapter

🚀 🦙 Ollama - MCPアダプタ

このアダプタは、シンプルなPythonアダプタとオプションのランタイムサービスを使用して、MCPO（MCPから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

アダプタを使用してすべての利用可能な関数を取得できます。

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

📂 プロジェクト構造

ollama_mcpo_adapter/
├── adapter.py        # ツールの検出 + Ollama 統合
├── service.py        # オプション：MCPOをプログラムで起動
├── service_runner.py # MCPO子プロセスの制御
├── config_parser.py  # MCP設定の解析ヘルパー
├── dispatcher.py     # ツールの呼び出しを分散

📜 ライセンス

MITライセンスです。詳細は LICENSE を参照してください。