Vsc MCP

🚀 VSC-MCP ツール

このプロジェクトは、MCP (モデルコンテキストプロトコル) ツールを通じて言語サーバープロトコル（LSP）機能を呼び出すツールを提供します。これにより、AIエージェントは標準化されたMCPツールを使用して、プログラム的にTypeScript/JavaScriptコードを分析および編集することができます。

✨ 主な機能

• 単一ファイルモードまたはプロジェクトモード（tsconfig.json ファイルを検出）をサポートします。
• LSP APIを通じて言語に依存しないコード操作を実現します。
• モデルコンテキストプロトコル (MCP) SDKと完全に互換性があります。

📦 インストール

前提条件

• Bun（パッケージ管理とビルドに使用）
• Node.js（サーバーを実行するため）

セットアップ

1. リポジトリをクローンします。
2. 依存関係をインストールします。

bun install

🔧 セキュリティ機能

パス制限

VSC-MCPツールには、ファイル操作が許可されていないディレクトリにアクセスするのを防ぐセキュリティ機能が含まれています。

• ALLOWED_DIRECTORIES：環境変数で、ファイル操作が許可されるディレクトリのカンマ区切りリストを指定します。 例：

  ALLOWED_DIRECTORIES=/home/user/projects,/tmp/workspace
  

• この環境変数が設定されていない場合、デフォルトでは現在の作業ディレクトリ内の操作のみが許可されます。
• すべてのファイル操作（読み取り、書き込み、編集）では、対象パスが許可されたディレクトリ内にあるかどうかがチェックされます。
• 許可されたディレクトリ外のファイルにアクセスしようとすると、「アクセスが拒否されました」エラーが発生します。

この機能は、システム上の敏感なファイルやディレクトリへの不正アクセスを防ぐのに役立ちます。

🔧 技術詳細

動作原理

• 標準入出力モードでTypeScript言語サーバーを起動します。
• LSPのinitializeおよびdidOpen通知を送信します。
• workspace/symbolおよびtextDocument/documentSymbolリクエストを使用してシンボルを検索します。
• シンボルが見つからない場合、textDocument/implementationにフォールバックして追加のシンボル検出を行います。
• applyWorkspaceEditツールを使用してファイルに直接編集操作を適用します。
• 操作結果を呼び出し元に返します。

利用可能なツール

現在、以下のツールが利用可能です。

• editSymbol：LSPを通じて名前とタイプでファイル内のシンボル（関数、クラス、メソッドなど）を編集します。

  • サポートされるシンボルタイプには、関数、メソッド、クラス、インターフェース、変数、定数、プロパティ、フィールドが含まれます。
  • LSPのworkspace/symbolおよびtextDocument/documentSymbolリクエストを使用してシンボルを検索します。
  • ファイルパスや位置などの構造化された情報を返します。

• readSymbol：LSPを通じて名前とタイプでファイル内のシンボル（関数、クラス、メソッドなど）を読み取ります。

  • サポートされるシンボルタイプには、関数、メソッド、クラス、インターフェース、変数、定数、プロパティ、フィールドが含まれます。
  • LSPのworkspace/symbolおよびtextDocument/documentSymbolリクエストを使用してシンボルを検索します。
  • ファイルパスや位置などの構造化された情報を返します。

• findReferences：LSPを通じてファイル内のシンボル（関数、クラスなど）のすべての参照を見つけます。

  • サポートされるシンボルタイプには、関数、メソッド、クラス、インターフェース、変数、定数、プロパティ、フィールドが含まれます。
  • LSPのtextDocument/referencesリクエストを使用してすべてのシンボル参照を検索します。
  • ファイルパスや位置を含む参照リストを返します。
  • コード分析、リファクタリング、およびコードの使用状況の理解に役立ちます。

• getDefinition：LSPを通じてシンボル（関数、クラスなど）の定義を取得します。

  • サポートされるシンボルタイプには、関数、メソッド、クラス、インターフェース、変数、定数、プロパティ、フィールドが含まれます。
  • LSPのtextDocument/definitionリクエストを使用してシンボルの定義を取得します。
  • ファイルパスや位置などの構造化された情報を返します。

• getDocumentation：LSPを通じてシンボル（関数、クラスなど）のドキュメントコメントを取得します。

  • サポートされるシンボルタイプには、関数、メソッド、クラス、インターフェース、変数、定数、プロパティ、フィールドが含まれます。
  • LSPのtextDocument/hoverおよびtextDocument/documentSymbolリクエストを使用してドキュメント情報を取得します。
  • ドキュメント内容や位置などの構造化された情報を返します。

• getCodeIssues：LSPを通じてコードの問題をチェックします。

  • LSPのtextDocument/formattingおよびtextDocument/typeDefinitionリクエストを使用してコードの形式と型定義をチェックします。
  • エラー、警告、位置などの構造化された情報を返します。