Manticore MCP Server

🚀 Manticore Search MCP Server

Manticore Searchの機能に、Claude CodeやCursorなどのMCP互換クライアントやその他のAI開発ツールからアクセスできるようにする、Model Context Protocol (MCP) サーバーです。

✨ 主な機能

• 高度なクエリオプションを備えた全文検索
• テーブル/インデックスの管理操作
• ドキュメントの挿入と操作
• クラスターのステータス監視
• ハイライトとファジー検索を備えたブールクエリ
• 結果の制限とページネーションの設定可能

📦 インストール

前提条件

• Go 1.24 以上
• 実行中でアクセス可能なManticore Searchサーバー

ビルド

git clone https://github.com/krajcik/manticore-mcp-server.git
cd manticore-mcp-server
go build -o manticore-mcp-server

📚 ドキュメント

設定

環境変数を使用して設定します。

export MANTICORE_URL="http://localhost:9308"
export MAX_RESULTS_PER_QUERY="100"
export REQUEST_TIMEOUT="30s"
export DEBUG="false"

または、コマンドラインフラグを使用します。

./manticore-mcp-server --manticore-url="http://localhost:9308" --max-results=100

MCPクライアントの統合

MCPクライアントの設定（例: Claude Codeの場合は ~/.claude.json）に追加します。

{
  "mcpServers": {
    "manticore-search": {
      "command": "/path/to/manticore-mcp-server",
      "args": [],
      "env": {
        "MANTICORE_URL": "http://localhost:9308",
        "MAX_RESULTS_PER_QUERY": "50"
      }
    }
  }
}

利用可能なツール

MCPプロトコルは、これらのツールを自動的にクライアントに公開します。

search

Manticoreインデックスの全文検索。

主要パラメータ:

• table (必須): テーブル名
• query: 検索テキスト
• limit: 最大結果数
• highlight: 結果のハイライトを有効にする
• bool_query: 複雑なブールクエリ

show_tables

利用可能なテーブル/インデックスの一覧を表示。

describe_table

テーブルのスキーマ情報を取得。

パラメータ:

• table (必須): テーブル名

insert_document

インデックスにドキュメントを挿入。

パラメータ:

• table (必須): テーブル名
• document (必須): ドキュメントデータ

show_cluster_status

クラスターのヘルスステータスを表示。

レスポンス形式

すべてのツールは構造化されたJSONを返します。

{
  "success": true,
  "data": { /* 結果 */ },
  "meta": {
    "total": 42,
    "count": 10,
    "operation": "search"
  }
}

APIの自動検出

MCPクライアントは、プロトコルを通じて利用可能なツールとそのスキーマを自動的に検出します。手動での設定は必要ありません。

トラブルシューティング

接続問題

• Manticoreが実行中であることを確認: curl http://localhost:9308
• MCP設定内のサーバーパスを確認
• 詳細なログを表示するには --debug を使用

パフォーマンス

• MAX_RESULTS_PER_QUERY を必要に応じて調整
• 複雑なクエリの場合は REQUEST_TIMEOUT を増やす

📄 ライセンス

MITライセンス