MCP Server (Language Server Protocol)

MCP サーバー（Language Server Protocol）

複数の検索戦略に対応した、コード参照検索のための TypeScript ベースの Language Server Protocol 実装です。

特徴

• 🔍 ripgrep を使用した高速なコード参照検索
• 🌐 手軽に検索できる Web インターフェース
• 💻 コマンドラインで利用できるターミナルインターフェース
• 📊 ファイルの種類ごとにグループ化された結果
• 🔄 フォールバック検索機能
• 🔥 開発時のホットリロードに対応

前提条件

開始する前に、以下がインストールされていることを確認してください。

• Node.js（v14 以降）
• npm（Node.js に付属）
• Homebrew（macOS ユーザー向け）
• ripgrep（高速な検索のため推奨）

インストール

1. リポジトリをクローンする

git clone <your-repository-url>
cd <repository-name>/src/mcp-server/v1

2. Homebrew をインストールする（macOS のみ）

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Add Homebrew to PATH (follow the instructions shown after installation)
# Usually these commands:
(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# Restart your terminal or run
source ~/.zprofile

3. ripgrep をインストールする

# macOS (using Homebrew)
brew install ripgrep

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install ripgrep

# Fedora
sudo dnf install ripgrep

# Windows (using Chocolatey)
choco install ripgrep

4. 依存関係をインストールする

npm install

使い方

プロジェクトをビルドする

npm run build

サーバーを起動する

本番モード

npm run start

開発モード（ホットリロードあり）

npm run dev

インターフェースにアクセスする

1. Web インターフェース

   • ブラウザーを開き、次の URL にアクセスします：http://localhost:3000
   • 検索語とディレクトリを入力します
   • ファイルの種類ごとにグループ化された結果を確認します

2. ターミナルインターフェース

   • ターミナルインターフェースはサーバーとともに自動的に起動します
   • プロンプトに従って検索語を入力します
   • 結果がターミナルに表示されます

検索戦略

サーバーは次の順序で複数の検索戦略を使用します。

1. ripgrep（最速）

   • 正規表現を使用して完全一致と部分一致を検索します
   • 一般的なディレクトリ（node_modules、.git など）を除外します
   • 行番号とコンテキストを表示します

2. grep（フォールバック）

   • ripgrep が利用できない場合に使用します
   • 機能は似ていますが、速度は遅くなります

3. Node.js（最終フォールバック）

   • JavaScript のみで実装されています
   • ripgrep も grep も利用できない場合に使用します

設定

環境要件

• サーバーは必要なソフトウェアを自動的に確認します
• 不足しているソフトウェアがある場合、インストール手順を表示します
• 作業ディレクトリが正しいことを確認します

TypeScript の設定

• ターゲット：ES2020
• モジュール：CommonJS
• 厳密な型チェックを有効化
• デバッグ用のソースマップを生成

トラブルシューティング

よくある問題

1. ディレクトリが正しくない

   • src/mcp-server/v1 ディレクトリにいることを確認してください
   • 環境チェックに表示されるパスを確認してください

2. Homebrew のインストール

   • Homebrew コマンドが失敗する場合は、PATH が設定されていることを確認してください
   • ~/.zprofile で Homebrew の設定を確認してください

3. ripgrep が見つからない

   • Homebrew がインストールされ、PATH に設定されていることを確認してください
   • 再インストールを試してください：brew reinstall ripgrep

4. ポートがすでに使用されている

   • サーバーは利用可能なポートを自動的に探します
   • デフォルトのポートは 3000 です

エラーメッセージ

以下のエラーが表示された場合は、次の方法をお試しください。

1. command not found: brew

   • Homebrew を再インストールします
   • PATH を再設定します

2. command not found: rg

   • ripgrep をインストールします：brew install ripgrep
   • PATH の設定を確認します

3. EADDRINUSE

   • ポートが使用中です
   • サーバーは自動的に別のポートを試します

開発

利用可能なスクリプト

• npm run build：プロジェクトをビルドします
• npm run start：本番モードで起動します
• npm run dev：ホットリロード付きで起動します
• npm run clean：ビルド出力を削除します

新機能の追加

1. コア機能を変更するには server.ts を編集します
2. Web インターフェースの変更には index.html を更新します
3. 開発モードで実行して変更をテストします
4. ビルドして再起動し、変更を適用します