MCP-LSP Bridge

MCP LSP Bridge

Claude Code などの MCP 対応エージェントに、Language Server Protocol の機能を提供します。20 以上のプログラミング言語で、コードの分析、ナビゲーション、リファクタリングができます。

ステータス

積極的に開発中です — 現在、コア機能は動作していますが、頻繁な機能改善やインターフェースの変更が予想されます。

ロードマップ

• 小規模モデル、Qwen3-4B、量子化モデルのパフォーマンスを改善する
• LSP ツールの検出と使用を改善する
• 公開するツールの数を減らす機能を追加する（名前変更やフォーマットは優先度を下げ、オプションにする場合があります）
• デフォルト設定オプションや、スクリプトで扱える個別の設定オプションを用意して、導入を簡単にする（LSP 設定をスクリプト化できるよう、Lua のような仕組みを検討します）

クイックスタート

1. インストール: リリースからダウンロードするか、go build でビルドします
2. 設定: MCP クライアント（Claude Code など）に追加します。

   {
     "mcpServers": {
       "lsp": {
         "type": "stdio",
         "command": "mcp-lsp-bridge",
         "args": [],
         "env": {}
       }
     }
   }
   

3. 設定場所にある lsp_config.json で LSP サーバーを設定します：default-directory-locations

• または、MCP クライアントの設定内で mcp-lsp-bridge --config /path/to/my-config.json を指定します。

4. 使用: MCP クライアントから LSP ツールにアクセスします

詳しい設定方法については、docs/configuration.md を参照してください。

できること

MCP 対応エージェントに LSP 機能を提供します。

コードインテリジェンス: ドキュメントの取得、定義の検索、参照の追跡、エラーの特定

安全なリファクタリング: シンボルの名前変更、コードのフォーマット、クイックフィックスの適用（プレビュー機能付き）

プロジェクト分析: コードベース全体の検索、プロジェクト構造の把握、言語の検出

Go、Python、TypeScript、Rust、Java、C#、C++ を含む 20 以上の言語に対応しています。

設定

言語サーバーを定義する lsp_config.json ファイルが必要です。配置場所については、configuration.md を参照してください。

設定を指定する基本的な例（プロジェクトごとに個別の設定を使いたい場合に便利です）：

mcp-lsp-bridge --config lsp_config.json

.mcp.json またはその他の MCP 設定に追加します。

{
  "mcpServers": {
    "lsp": {
      "type": "stdio",
      "command": "mcp-lsp-bridge",
      "args": ["--config", "lsp_config.json"],
      "env": {}
    }
  }
}

設定手順の詳細については、docs/configuration.md を参照してください。

利用可能なツール

コードの分析と操作に使える 16 個の MCP ツール：

• 分析: シンボル検索、プロジェクトの調査、診断
• ナビゲーション: 定義、参照、実装の検索
• リファクタリング: シンボルの名前変更、コードのフォーマット、修正の適用
• インテリジェンス: ホバー情報、シグネチャ、セマンティックトークン

📚 ドキュメント：

• コードベースガイド - アーキテクチャと構造の概要 🆕
• ツールリファレンス - ツールの一覧
• 分析の概要 - クイックスタートガイド
• プロジェクト分析ガイド - 分析ツールの詳細ガイド
• シンボル探索ガイド - スマートなシンボル検索ガイド

Docker

ベースイメージを利用できます（LSP サーバーは含まれていません）。

docker pull ghcr.io/rockerboo/mcp-lsp-bridge:latest

必要な LSP サーバーを追加するには、イメージを拡張してください。例については、docs/configuration.md を参照してください。

貢献

貢献を歓迎します。主要な詳細をまとめた貢献者向けドキュメントを作成している間、変更をマージできるようサポートします。

問題や改善案があれば、Issue を作成してください。