ickyMCP

セマンティックドキュメント検索のためのRAG MCPサーバーです。ローカルのドキュメントコレクションを sqlite-vec を使用してSQLiteにインデックス化し、インデックス作成、検索、更新、一覧表示、削除を行うためのMCPツールを提供します。

特徴

• PDF、Word、PowerPoint、Excel、Markdown、テキストファイルに対するセマンティック検索

• ユーザーごとのデータベース分離（オプションで従来のシングルデータベースモードも利用可能）

• チャットや案件単位の検索のためのドキュメントIDフィルタリング

• ファイルサイズと更新日時による増分インデックス作成

• デフォルトでVoyage AI埋め込みを使用、オフラインのローカルsentence-transformersバックエンドも利用可能

• ポータブルなSQLiteストレージ（ローカルデータベースのアーティファクトは無視されます）

Related MCP server: MCP-RAGNAR

セットアップ

python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt

例からローカル環境設定を作成します：

copy .env.example .env

デフォルトのVoyageバックエンドを使用する場合は ICKY_VOYAGE_API_KEY を設定してください。オフラインで使用する場合は ICKY_EMBEDDING_PROVIDER=local を設定します。

設定

Claude MCP設定

{
  "mcpServers": {
    "ickyMCP": {
      "command": "python",
      "args": ["C:\\Users\\devan\\OneDrive\\Desktop\\Projects\\ickyMCP\\run.py"],
      "env": {
        "ICKY_EMBEDDING_PROVIDER": "voyage",
        "ICKY_VOYAGE_API_KEY": "YOUR_VOYAGE_API_KEY",
        "ICKY_CHUNK_SIZE": "5000",
        "ICKY_CHUNK_OVERLAP": "500"
      }
    }
  }
}

ツール

• index: ファイルまたはディレクトリをインデックス化します。user_id、patterns、exclude、force を受け付けます

• search: インデックス化されたチャンクに対するセマンティッククエリ。document_ids、path_filter、file_types を受け付けます

• similar: 提供されたテキストに類似したチャンクを検索します

• refresh: 変更されたファイルを再インデックス化し、削除されたファイルをインデックスから削除します

• list: インデックス化されたドキュメントとそのIDを一覧表示します

• delete: パス、ドキュメントID、またはすべてのドキュメントを指定して削除します

• status: データベース、埋め込み、チャンク化のステータスを返します

検証

python -m compileall -q src run.py fast_index.py
python -c "from src.config import EMBEDDING_PROVIDER; print(EMBEDDING_PROVIDER)"

ルートにある test_*.py ファイルは、docs/ 配下のローカルドキュメントと、デフォルトバックエンドの場合は設定済みのVoyage APIキーを必要とする統合テストスクリプトです。

データ衛生

生成されたデータベースおよびローカルドキュメントフォルダはgitによって無視されます：*.db、*.db.bak、*.sqlite、*.sqlite3、data/、docs/。実際のAPIキーは追跡対象のファイルではなく、環境変数または .env に保持してください。

ライセンス

MIT