VSCode Context MCP

VSCode Context MCP

AI アシスタント向けに VSCode のコンテキストとファイルシステム操作を提供する Model Context Protocol（MCP）サーバーです。

概要

VSCode Context MCP は、AI アシスタントと VSCode 環境をつなぎます。AI モデルは次のことができます。

1. 現在の VSCode コンテキスト（アクティブなファイル、タブ、ターミナルの出力）にアクセスする
2. 制御された方法でファイルシステムを操作する
3. 制御された環境でシェルコマンドを実行する

これにより、AI アシスタントはソフトウェア開発タスクに対して、より関連性が高く、コンテキストを踏まえた支援を提供できます。

機能

VSCode コンテキストへのアクセス

• 現在のプロジェクトパスを取得する
• アクティブなファイルの内容とメタデータを取得する
• 開いているエディタータブを一覧表示する
• 診断上の問題（警告／エラー）にアクセスする
• ターミナルの出力を取得する
• ワークスペースに添付されたファイルにアクセスする

ファイルシステム操作

• ファイルの読み取り／書き込み
• 行単位の変更によるファイル編集
• ディレクトリの作成
• ディレクトリの内容の一覧表示
• ディレクトリツリーの生成
• ファイルの検索
• ファイルのメタデータの取得
• ファイルの移動／名前変更

コマンドの実行

• 出力を取得しながらシェルコマンドを実行する
• 制御された実行環境

⚠️ セキュリティに関する警告

このサーバーに実行させるコマンドには注意してください！ Claude Desktop アプリでは、各コマンドを確認できるように Allow for This Chat ではなく Approve Once を使用し、コマンドを信頼できない場合は Deny を選択してください。権限はサーバーを実行するユーザーによって決まります。

このツールにはまだ包括的なセキュリティ対策が実装されていないため、注意して使用してください。

AI アシスタントとの連携

この MCP サーバーは、Model Context Protocol に対応した AI アシスタントと連携するように設計されています。次の機能を強化します。

• コードのコンテキストを理解する
• 情報に基づいた提案を行う
• 関連性の高い例を提示する
• 問題のデバッグを支援する
• 代わりにファイルを操作する

1. VSCode 拡張機能をインストールする

注： インストールする前に、競合を避けるため、filesystem MCP などの類似する MCP サーバーをアンインストールすることをおすすめします。

• VSIX パッケージをこちらからダウンロードします
• VSCode を開きます
• Ctrl+Shift+P（Windows/Linux）または Cmd+Shift+P（macOS）を押して、コマンドパレットを開きます
• "Extensions: Install from VSIX..." と入力して選択します
• ダウンロードした VSIX ファイルに移動して選択します
• インストール後、VSCode を再起動します

詳しくは、VSCode 拡張機能のリポジトリをご覧ください。

2. MCP サーバーをセットアップして実行する

まず、このリポジトリをクローンするかダウンロードします。次に、依存関係をインストールし、プロジェクトをビルドします。

cd path/to/vscode-context-mcp
npm install
npm run build

ビルドが完了したら、MCP サーバーを使用するように Claude Desktop の設定を更新します。

{
  "mcpServers": {
    "vscode-context-mpc": {
      "command": "node",
      "args": [
        "C:\\path\\to\\vscode-context-mcp\\dist\\index.js"
      ]
    }
  }
}

注： args 配列内のファイルパスが、実際のプロジェクトの場所と一致していることを確認してください。

3. 接続をテストする

すべてが正しく動作していることを確認するには、Claude で次のプロンプトを使用してみてください。

Please check my current VSCode project and tell me what files I have open.

4. Claude のコンテキストにファイルを追加する

Claude のコンテキストにファイルを追加する方法はいくつかあります。

• Ctrl+L（Windows/Linux）または Cmd+L（macOS）を押して、現在のファイルを追加します
• Ctrl+I または Cmd+I を押して、選択したテキストのみを追加します
• コマンドパレット（Ctrl+Shift+P または Cmd+Shift+P）を開き、次の項目を検索します。
  • "Add File to Context"
  • "Add Selection to Context"

ツールリファレンス

ツール名	説明
get_vscode_context	VSCode のコンテキスト情報をすべて取得します
get_attached_files	ワークスペースに添付されたファイルの一覧を取得します
get_project_path	現在のプロジェクトのルートディレクトリを取得します
get_current_file	アクティブなファイルの詳細と内容を取得します
get_open_tabs	開いているエディタータブをすべて一覧表示します
get_problems	診断情報（エラー／警告）を取得します
get_terminal_content	ターミナルの出力と履歴を取得します
run_command	シェルコマンドを実行します
read_file	ファイルの内容を読み込みます
read_multiple_files	複数のファイルを一度に読み込みます
write_file	ファイルを作成または上書きします
edit_file	行単位でファイルを編集します
create_directory	ディレクトリ構造を作成します
list_directory	ファイルとディレクトリを一覧表示します
directory_tree	ディレクトリ構造を再帰的に取得します
move_file	ファイルとディレクトリを移動または名前変更します
search_files	パターンに一致するファイルを検索します
get_file_info	ファイルの詳細なメタデータを取得します

ロードマップ

1. 複数の VSCode プロジェクトへの対応
2. ファイルの書き込みや編集時の承認／取り消し機能
3. UI の再設計

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。