Bmorphism Krep MCP Server

🚀 Krep MCP サーバー

Krep MCP サーバーは、モデルコンテキストプロトコル (Model Context Protocol) に基づく高性能な文字列検索ツールです。ファイルや文字列内での効率的な検索を行うための統一インターフェースを提供します。

🚀 クイックスタート

Krep MCP サーバーのインストールと使用は簡単です。以下の手順を参照してください。

📦 インストール

Krep MCP サーバーのインストールは非常に簡単です。

1. このリポジトリをクローンします。
2. krep-mcp-server ディレクトリに移動します。
3. Node.js を使用してメインプログラムを実行します。

インストールコマンド例

git clone https://github.com/your-username/krep-mcp-server.git
cd krep-mcp-server
node src/index.js

✨ 主な機能

Krep MCP サーバーは以下の主要機能を提供します。

1. 統一インターフェース：単一の関数でファイル検索、文字列検索、およびカウント機能を実現します。
2. 高性能アルゴリズム：
   • パターンの長さに基づいて最適なアルゴリズム（KMP、Boyer - Moore - Horspool、Rabin - Karp）を自動的に選択します。
   • SIMD 命令による加速をサポートします。
3. マルチスレッドサポート：すべての CPU コアを自動的に利用して検索効率を向上させます。

💻 使用例

リクエスト形式

<use_mcp_tool>
<server_name>krep</server_name>
<tool_name>krep</tool_name>
<arguments>
{
  "pattern": "search pattern",
  "target": "file path or string to search",
  "mode": "file|string|count",
  "caseSensitive": true|false,
  "threads": null // 自動的に CPU コア数を検出し、デフォルトは自動モード
}
</arguments>
</use_mcp_tool>

パラメータ説明

• pattern (必須)：検索するパターン文字列です。
• target (必須)：ファイルパスまたは検索対象の文字列です。
• mode (オプション)：
  • file（デフォルト）：ファイル内を検索します。
  • string：文字列内を検索します。
  • count：出現回数のみをカウントします。
• caseSensitive (オプション)：大文字と小文字を区別するかどうかで、デフォルトは true です。
• threads (オプション)：使用するスレッド数で、デフォルトは自動的に CPU コア数を検出します。

使用例

具体的な使用例は examples.md を参照してください。

📚 ドキュメント

性能最適化

Krep MCP サーバーは性能に重点を置いて設計されています。

1. アルゴリズム選択：
   • 極短いパターン（<3 文字）には KMP アルゴリズムを使用します。
   • 中程度の長さのパターン（3 - 16 文字）には Boyer - Moore - Horspool アルゴリズムを使用します。
   • 長いパターン（>16 文字）には Rabin - Karp アルゴリズムを使用します。
2. ハードウェア加速：SIMD 命令を利用して性能を向上させます。
3. 動的マルチスレッド：すべての利用可能な CPU コアを自動的に利用します。

Cline VSCode プラグインとの統合

Krep MCP サーバーは Cline VSCode プラグインとシームレスに統合でき、VSCode 環境で直接高性能な検索機能を使用できます。

インストール手順

# プラグインをインストールする
./install-cline-integration.sh

# プラグインをテストする前にインストールする
./run-cline-test.sh

# プラグインをアンインストールするときに実行する
./uninstall-cline-integration.sh

Cline での使用

統合が完了したら、Cline 対話で直接 krep を使用できます。

/krep krep pattern="function" target="/path/to/search" mode="file"

詳細なインストールと使用方法については、以下を参照してください。

• CLINE_SETUP.md - インストールガイド
• CLINE_README.md - 使用説明

Infinity Topos 環境への統合

Krep MCP サーバーは、Infinity Topos 環境にシームレスに統合するための方案を設計しています。

• Babashka 統合：検索結果を処理するために使用されます。
• Say 統合：Say MCP サーバーを介して検索結果を音声で通知します。
• Coin - Flip 統合：ランダム化を利用して検索戦略を決定します。

開発環境

環境変数

• CLAUDE_MCP："true" に設定すると、MCP モードが有効になります。
• KREP_PATH：krep 実行可能ファイルのパスを指定します。
• DEBUG："true" に設定すると、詳細なログ出力が有効になります。
• KREP_TEST_MODE："true" に設定すると、テストモードに入り、模擬応答を使用します。
• KREP_SKIP_CHECK："true" に設定すると、krep の存在チェックをスキップします。

HTTP サーバーモード

非 MCP モードでは、サーバーは以下のエンドポイントを起動します。

1. /api/search：
   • POST リクエストの本文に検索パラメータを含める必要があります。

📄 ライセンス

このプロジェクトは MIT License に準拠しています。

貢献者

すべての貢献者に感謝します！

リンク

• GitHub リポジトリ
• 問題報告