Manticore Search

Name: Manticore Search
Author: manticoresoftware

ローカル

github.com/manticoresoftware検索530 週間前に更新

リポジトリ

Manticore Search について

Manticore Search MCP Serverは、AIアシスタントによるManticore Searchデータベースのクエリやスキーマ、ドキュメントの確認を可能にします。SQLクエリに対応し、書き込みと破壊的操作はデフォルトで無効です。

主な機能

01SQLクエリの実行
02テーブルとインデックスの一覧表示
03テーブルスキーマの確認
04Manticoreドキュメントの取得
05書き込みと削除操作の任意制御

活用シーン

01Manticoreデータベースへのクエリ
02利用可能なテーブルとスキーマの確認
03Manticoreマニュアルの参照
04データベース変更時に書き込みを有効化

MCP 対応

クエリ、スキーマ、ドキュメントのツールと、組み込みのManticore案内プロンプトをMCPクライアントに公開します。ローカルstdioと設定可能なHTTPトランスポートに対応します。

#manticore #search #database #full-text #vector #mcp #ai

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": [
        "mcp-manticore"
      ]
    }
  }
}

起動コマンドuvx mcp-manticore

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypimcp-manticore0.1.2stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
query	string	はい	実行する SQL クエリ（例："SELECT * FROM my_index LIMIT 10"）

詳細

Manticore Search MCP サーバー

Manticore Search 用の MCP サーバーです。AI アシスタントから Manticore Search データベースを直接クエリし、管理できます。

クイックスタート

インストール

# Option 1: Install with uv (recommended, requires PyPI release)
uvx mcp-manticore

# Option 2: Install with pip
pip install mcp-manticore

# Option 3: Run from source (for local development)
uvx --from . mcp-manticore
# Or: uv run mcp-manticore

注：

uvx は、インストールせずにパッケージを直接実行します。初回の実行時は、依存関係のダウンロードに時間がかかる場合があります。

uvx mcp-manticore を使用するには、パッケージが PyPI に公開されている必要があります。

ローカルでの開発や未リリースバージョンのテストには、uvx --from . mcp-manticore を使用してください。

機能

ツール

ツール	説明
`run_query`	SQL クエリを実行します（SELECT、SHOW、DESCRIBE など）
`list_tables`	すべてのテーブルとインデックスを一覧表示します
`describe_table`	テーブルのスキーマを取得します
`list_documentation`	利用可能なドキュメントファイルを一覧表示します
`get_documentation`	Manticore のマニュアルから指定したドキュメントを取得します

プロンプト

manticore_initial_prompt — Manticore Search の機能（全文検索演算子、KNN ベクトル検索、あいまい検索など）を LLM に教える組み込みプロンプトです。

ヘルスチェック

接続状況の監視用に、/health の HTTP エンドポイントを提供します。

設定

環境変数

変数	デフォルト	説明
`MANTICORE_HOST`	`localhost`	Manticore サーバーのホスト
`MANTICORE_PORT`	`9308`	HTTP API ポート
`MANTICORE_USER`	—	ユーザー名（任意）
`MANTICORE_PASSWORD`	—	パスワード（任意）
`MANTICORE_CONNECT_TIMEOUT`	`30`	接続タイムアウト（秒）
`MANTICORE_QUERY_TIMEOUT`	`30`	クエリのタイムアウト（秒）
`MANTICORE_ALLOW_WRITE_ACCESS`	`false`	書き込み操作（INSERT、UPDATE、DELETE）を有効にします
`MANTICORE_ALLOW_DROP`	`false`	破壊的操作（DROP、TRUNCATE）を有効にします
`GITHUB_TOKEN`	—	GitHub の API レート制限を緩和するためのトークン

安全性

デフォルトでは、すべての書き込み操作がブロックされています。有効にするには：

# Enable writes (INSERT, UPDATE, DELETE)
export MANTICORE_ALLOW_WRITE_ACCESS=true

# Enable destructive operations (DROP, TRUNCATE)
export MANTICORE_ALLOW_DROP=true

AI アシスタントに接続する

Claude Code

ターミナルを開いて、次を実行します。

claude mcp add manticore -- uvx mcp-manticore

または、環境変数を指定します。

claude mcp add manticore -- uvx mcp-manticore -- \
  MANTICORE_HOST=localhost \
  MANTICORE_PORT=9308

完全な設定を行うには、~/.claude/mcp_settings.jsonを編集します。

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

変更を適用するには、Claude Codeを再起動するか、/mcp restartと入力します。

Cursor

方法 1：設定 UI から

Cursor → Settings → Tools & MCP を開きます
「Add MCP Server」をクリックします
名前にmanticoreを入力します
コマンドにuvx mcp-manticoreを入力します

方法 2：設定ファイルから

グローバル設定（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

プロジェクト設定（プロジェクト内の.cursor/mcp.json）：

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"]
    }
  }
}

Windsurf

方法 1：Cascade UI から

Windsurf → Cascade パネルを開きます
右上の MCP アイコン（🔨）をクリックします
「Add Server」をクリックします
uvx mcp-manticoreを入力します

方法 2：設定ファイルから

~/.codeium/windsurf/mcp_config.jsonを編集します。

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

または、Windsurf で直接開きます：Cmd/Ctrl + Shift + P → 「MCP Configuration Panel」

OpenAI Codex

ターミナルで次を実行します。

codex mcp add manticore -- uvx mcp-manticore

環境変数を指定する場合：

codex mcp add manticore \
  --env MANTICORE_HOST=localhost \
  --env MANTICORE_PORT=9308 \
  -- uvx mcp-manticore

または、~/.codex/config.tomlを直接編集します。

[mcp_servers.manticore]
command = "uvx"
args = ["mcp-manticore"]
env = { MANTICORE_HOST = "localhost", MANTICORE_PORT = "9308" }

Gemini CLI

~/.gemini/settings.jsonを編集します。

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

VS Code (GitHub Copilot)

ワークスペースに.vscode/mcp.jsonを作成します。

{
  "servers": {
    "manticore": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Cline

VS Code で Cline パネルを開きます
MCP サーバーアイコンをクリックします
「Configure」→「Add Server」をクリックします
「Command (stdio)」を選択して、次を入力します。
- 名前：manticore
- コマンド：uvx mcp-manticore

または、MCP 設定ファイルを直接編集します（MCP サーバーアイコン →「Edit Config」からアクセスできます）。

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Roo Code

VS Code で Roo Code パネルを開きます
MCP サーバーアイコン →「Edit MCP Settings」をクリックします
サーバー設定を追加します

または、プロジェクトのルートに.roo/mcp.jsonを作成します。

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Claude Desktop (Legacy)

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または%APPDATA%/Claude/claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

HTTP トランスポート（リモート MCP）

デフォルトでは、MCP は stdio（ローカル）を使用します。リモートアクセスの場合：

export MANTICORE_MCP_SERVER_TRANSPORT=http
export MANTICORE_MCP_BIND_PORT=8000
export MANTICORE_MCP_AUTH_TOKEN="your-secure-token"

uvx mcp-manticore

次の URL から接続します。

{
  "mcpServers": {
    "manticore": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer your-secure-token"
      }
    }
  }
}

トラブルシューティング

uv のインストール（必須）

macOS / Linux：

# Via installer script (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or via Homebrew
brew install uv

Windows：

# Via PowerShell
irm https://astral.sh/uv/install.ps1 | iex

# Or via winget
winget install astral-sh.uv

インストールの確認：

uv --version

MCP サーバーに接続できない

Manticore が実行中であることを確認します：curl http://localhost:9308/health
環境変数が正しく設定されていることを確認します
Claude Code の場合：/mcp restartを実行して再起動します

読み込まれるツールが多すぎる

一部のエージェントでは、アクティブな MCP ツールの数に制限があります。使用していないサーバーを削除するか、プロジェクト単位の設定を使用してください。

開発

# Clone and setup
git clone https://github.com/manticoresoftware/mcp-manticore.git
cd mcp-manticore

# Install dependencies
uv sync

# Run locally
uv run mcp-manticore

# Run with custom config
MANTICORE_HOST=remote-server MANTICORE_PORT=9308 uv run mcp-manticore

# Run tests
uv run pytest

# Build package
uv build

# Publish to PyPI
uv publish

アーキテクチャ

ファイル	目的
`mcp_manticore/mcp_env.py`	設定管理
`mcp_manticore/mcp_server.py`	MCP サーバーの実装
`mcp_manticore/manticore_prompt.py`	LLM 向けガイダンス／プロンプト
`mcp_manticore/docs_fetcher.py`	GitHub ドキュメント取得ツール
`mcp_manticore/main.py`	CLI エントリーポイント

ライセンス

Apache-2.0

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。