MCP Server (language Server Protocol)

🚀 MCP サーバー（言語サービスプロトコル）

このプロジェクトは、TypeScript をベースにした言語サービスプロトコルの実装です。コードの参照検索を行うことができ、複数の検索戦略をサポートしています。

✨ 主な機能

• 🔍 ripgrep を使用した高速なコード参照検索
• 🌐 検索を便利にするためのウェブインターフェースの提供
• 💻 コマンドラインでの使用をサポートするターミナルインターフェース
• 📊 ファイルタイプごとに結果をグループ化して表示
• 🔄 複数の代替検索メカニズム
• 🔥 開発時のホットリロードサポート

📦 インストール

前提条件

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

• 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 のみ）

# Homebrew をインストールする
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Homebrew を PATH に追加する（インストール後に表示される指示に従ってください）
# 通常はこれらのコマンドを実行します：
(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# ターミナルを再起動するか、以下のコマンドを実行します
source ~/.zprofile

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

# macOS（Homebrew を使用）
brew install ripgrep

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

# Fedora
sudo dnf install ripgrep

# Windows（Chocolatey を使用）
choco install ripgrep

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

npm install

💻 使用例

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

npm run build

サーバーを起動する

本番モード

npm run start

開発モード（ホットリロード付き）

npm run dev

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

ウェブインターフェース

• ブラウザで http://localhost:3000 を開きます。
• 検索ワードとディレクトリを入力します。
• ファイルタイプごとにグループ化された結果を確認します。

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

• ターミナルインターフェースはサーバーと一緒に自動的に起動します。
• 指示に従って検索ワードを入力します。
• 結果はターミナルに表示されます。

🔧 技術詳細

検索戦略

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

1. ripgrep（最速）

• 正規表現を使用して、正確なマッチと部分的なマッチを実現します。
• 一般的なディレクトリ（node_modules、.git など）を無視します。
• 行番号とコンテキストを提供します。

2. grep（代替）

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

3. Node.js（最後の代替策）

• 純粋な JavaScript で実装されています。
• ripgrep と grep の両方が使用できない場合に使用されます。

設定

環境要件

• サーバーは必要なソフトウェアを自動的にチェックします。
• 不足しているソフトウェアのインストール手順を提供します。
• 現在のディレクトリが正しいことを検証します。

TypeScript の設定

• ターゲット：ES2020
• モジュール：ESNext
• エクスポート：true
• フォーマット：UTF - 8
• 厳格モード：有効
• 未宣言の変数を許可：無効

トラブルシューティング

ネットワーク問題

ネットワークにアクセスできない場合は、ファイアウォール設定またはプロキシ構成を確認してください。

依存関係の問題

npm のインストールが失敗した場合は、管理者権限で以下のコマンドを実行してみてください。

npm install --force

その他の問題

さらに支援が必要な場合は、プロジェクトのドキュメントを参照するか、メンテナーに連絡してください。