Omnimcp

🚀 OmniMCP

MCPエコシステムのセマンティックルーター

コンテキストの肥大化を招くことなく、複数のMCPサーバー間でツールを発見し実行します

🚀 クイックスタート

OmniMCPを使い始めるには、以下の手順に従ってください。

1. MCPサーバーの設定ファイルを作成する

mcp-servers.json を作成します。これはClaude DesktopのMCP設定を拡張したスキーマで、OmniMCP固有のフィールドが追加されています。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",  // or "uvx", "docker", any executable
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"],
      "env": {},  // optional: environment variables for this server
      "timeout": 30.0,  // optional: seconds to wait for MCP server startup (default: 30)
      "hints": ["file operations", "read write files"],  // optional: help semantic search discover this server
      "blocked_tools": [],  // optional: tools to index but block at runtime
      "ignore": false,  // optional: skip indexing this server entirely
      "overwrite": false  // optional: force re-indexing even if already indexed
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {"GITHUB_TOKEN": "..."},
      "blocked_tools": ["delete_repository", "fork_repository"]  // indexed but execution blocked
    },
    "elevenlabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {"ELEVENLABS_API_KEY": "..."},
      "hints": [
        "When the user requests audio generation (speech or music), always execute in background mode",
        "Proactively offer to play audio using the ElevenLabs tool when contextually relevant"
      ]
    },
    "exa": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.exa.ai/mcp"],
      "env": {"EXA_API_KEY": "..."},
      "hints": [
        "Always execute web searches in background mode to avoid blocking the conversation",
        "Multiple Exa tool calls can be fired in parallel to efficiently gather information from different sources"
      ]
    }
  }
}

2. 環境変数を設定する

export OPENAI_API_KEY="sk-..."
export QDRANT_DATA_PATH="/path/to/qdrant_data"
export TOOL_OFFLOADED_DATA_PATH="/path/to/tool_offloaded_data"

3. サーバーをインデックスする

uvx --env-file .env omnimcp index --config-path mcp-servers.json

4. サーバーを起動する

# Default: HTTP transport (recommended)
uvx --env-file .env omnimcp serve --config-path mcp-servers.json --transport http --host 0.0.0.0 --port 8000

# stdio transport (for local MCP clients - requires pre-indexing)
uvx --env-file .env omnimcp serve --config-path mcp-servers.json --transport stdio

✨ 主な機能

コンテキスト肥大化の解消

OmniMCPは、単一の semantic_router ツールを介してMCPエコシステムにアクセスできるようにします。これにより、LLMは個々のツール定義を見ることなく、統一されたインターフェースを通じてツールを利用できます。

セマンティック検索

意図に基づいて関連するツールを検索できます。ツールは事前に埋め込みでインデックスされ、実行時に検索され、テキスト結果として返されます。

遅延サーバーロード

必要なときにのみサーバーを起動し、処理が終了したらシャットダウンします。

漸進的スキーマロード

実行前にのみ完全なJSONスキーマを取得し、会話中にテキストとして返します。

コンテンツオフロード

大きな結果はチャンク化され、画像は説明され、取得のために保存されます。

📦 インストール

uv pip install omnimcp // or uv add omnimcp 

💻 使用例

基本的な使用法

# サーバーからツールを検索する
search_tools("read CSV files and analyze data")
    → Returns: filesystem.read_file, database.query (ranked by relevance)

# ツールの詳細を取得する
get_tool_details("filesystem", "read_file")
    → Returns: Full JSON schema with parameters

# サーバーを管理する
manage_server("filesystem", "start")
    → Launches the server process

# ツールを実行する
execute_tool("filesystem", "read_file", {"path": "/data/sales.csv"})
    → Returns: File content (chunked if large)

高度な使用法

# バックグラウンドでツールを実行する
execute_tool("server", "slow_tool", args, in_background=True, priority=1)
# Returns: task_id

# タスクの状態を確認する
poll_task_result(task_id)
# Returns: status, result when done

📚 ドキュメント

環境変数の設定

OmniMCPを動作させるには、いくつかの環境変数を設定する必要があります。index または serve コマンドを実行する前に、これらを設定してください。

トランスポートモード

HTTPトランスポート（デフォルト - 推奨）

ほとんどのユースケースに適しています。リモートアクセス、Web統合、mcp-remote または mcp-proxy との使用に最適です。

uvx omnimcp serve --config-path mcp-servers.json --transport http --host 0.0.0.0 --port 8000

stdioトランスポート

標準入出力を介して通信するローカルMCPクライアント（Claude Desktop、Clineなど）に適しています。

uvx omnimcp serve --config-path mcp-servers.json --transport stdio

操作

🔧 技術詳細

アーキテクチャ: メタツールパターン

OmniMCPは、Claude CodeのAgent Skillsシステムに似たメタツールパターンを使用しています。個々のツールを数十個公開するのではなく、単一の semantic_router メタツールを介してMCPエコシステムにアクセスできるようにします。

Claude Skillsとの比較

Claude SkillsとOmniMCPは、同じアーキテクチャ上の洞察を共有しています。

📄 ライセンス

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