Isaacphi MCP Language Server

🚀 MCP 言語サーバー

Model Context Protocol (MCP) サーバーで、言語サーバーを実行し、それと通信するためのツールを提供します。

🎯 動機

Claude デスクトップと ファイルシステム サーバーを小型プロジェクトで使用すると、まるで魔法のような体験になります。しかし、いくつかのファイルやインポートを追加すると、その体験は崩れ始めます。このプロジェクトでは、大型プロジェクトにもこのような体験をもたらすことを目指しています。

言語サーバーは、LLM が苦労することの多いタスク、例えば型の正確な理解、関係の理解、正確なシンボル参照の提供などをうまく処理できます。このプロジェクトは、これらのツールを LLM にもたらすことを目的としています。LSP も MCP の明らかなインスピレーションの源のようです。では、それらを組み合わせてみましょう。

📈 状態

⚠️ プレベータ版の品質 ⚠️

このサーバーを以下の言語サーバーとテストしました：

• pyright（Python）
• tsserver（TypeScript）
• gopls（Go）
• rust - analyzer（Rust）

ただし、他の多くの言語サーバーとも互換性があるはずです。

🛠️ ツール

• read_definition：任意のシンボル（関数、型、定数など）の完全なソースコード定義を取得します。
• find_references：シンボルがコードベース内で使用されているすべての場所と参照を見つけます。
• get_diagnostics：特定のファイルに関する診断情報（警告やエラーを含む）を提供します。
• get_codelens：コードの要約ヒントを取得して、より多くのコンテキストやコード操作を得ます。
• execute_codelens：コードの要約操作を実行します。
• apply_text_edit：ファイルに複数のテキスト編集を適用できます。

この MCP サーバーは、言語サーバーの workspace/applyEdit リクエストを処理できるため、リファクタリングのリクエスト、インポートの追加、コードの整形などの操作を実行できます。

各ツールは、行番号の包含やコンテキストの追加など、出力をカスタマイズするためのさまざまなオプションをサポートしています。詳細については、ツールのドキュメントを参照してください。行番号は、apply_text_edit が正確な編集を行うために必要です。

ℹ️ 概要

このコードベースは、gopls の LSP 通信を処理する修正版のコードを使用しています。詳細については、ATTRIBUTION を参照してください。

[mcp - golang](https://github.com/metoro - io/mcp - golang) は MCP 通信に使用されています。

📋 前提条件

Go をインストールしてください。https://golang.org/doc/install の説明に従ってください。

このサーバーを取得または更新するには、次のコマンドを実行します：

go install github.com/isaacphi/mcp - language - server@latest

あなたのコードベースに言語サーバーをインストールします：

• Python（pyright）：npm install -g pyright
• TypeScript（tsserver）：npm install -g typescript typescript - language - server
• Go（gopls）：go install golang.org/x/tools/gopls@latest
• Rust（rust - analyzer）：rustup component add rust - analyzer
• または、任意の言語サーバーを使用します。

⚙️ 設定

Claude デスクトップの設定（または他の MCP 対応クライアント）に次のような設定を追加します：

{
  "mcpServers": {
    "language - server": {
      "command": "go",
      "args": [
        "run",
        "github.com/isaacphi/mcp - language - server@latest",
        "--workspace",
        "/Users/you/dev/yourpythoncodebase",
        "--lsp",
        "/opt/homebrew/bin/pyright",
        "--",
        "--stdio"
      ],
      "env": {
        "DEBUG": "1"
      }
    }
  }
}

以下を置き換えます：

• /Users/you/dev/yourpythoncodebase をあなたのプロジェクトの絶対パスに置き換えます。
• /opt/homebrew/bin/pyright をあなたの言語サーバーのパスに置き換えます（which コマンドを使用して探します。例：which pyright）。
• 任意の -- 記号の後のパラメータは、言語サーバーのパラメータとして渡されます。
• --stdio を他のバックエンドが必要とするパラメータに置き換えます。

開発環境では、設定 を参照して設定を行ってください。

🐞 デバッグ

env: {
  "DEBUG": 1
}

を含めることで、詳細な LSP およびアプリケーションログを取得できます。問題を報告する際には、できるだけ多くの情報を提供してください。

以下の機能が予定されています：

• [x] 定義の読み取り
• [x] 参照の取得
• [x] 編集の適用
• [x] 診断情報の取得
• [x] コード要約
• [ ] ホバー情報
• [ ] コード操作
• [ ] より良いコンテキストとキャンセル処理
• [ ] 言語サーバーの設定オプションの追加
• [ ] より一貫性があり拡張可能なツール API の作成（ページングなど）