Vscode Context MCP

🚀 VSCode コンテキスト MCP サービス

VSCode コンテキスト MCP サービスは、AI アシスタントに VSCode 環境のコンテキストとファイルシステム操作を提供する Model Context Protocol (MCP) サーバーです。これにより、AI アシスタントはソフトウェア開発タスクに関連した、コンテキストを考慮した支援を行うことができます。

🚀 クイックスタート

VSCode コンテキスト MCP は、AI アシスタントと VSCode 環境の間に橋渡しをします。これにより、AI モデルは以下のことが可能になります。

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

✨ 主な機能

VSCode コンテキストアクセス

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

ファイルシステム操作

• ファイルの読み取り/書き込み
• 行ベースのファイル変更
• ディレクトリの作成
• ディレクトリの内容を一覧表示する
• ディレクトリツリーを生成する
• ファイルを検索する
• ファイルのメタデータを取得する
• ファイルの移動/名前変更

コマンド実行

• 出力をキャプチャしてシェルコマンドを実行する
• 実行環境を制御する

⚠️ セキュリティ警告

⚠️ 重要提示

このサーバーで実行する内容には十分に注意してください！Claude Desktop アプリでは、Approve Once（Allow for This Chat ではなく）を使用して、各コマンドを確認できるようにし、信頼できないコマンドの場合は Deny を使用してください。権限はサーバーを実行しているユーザーによって決定されます。このツールには完全なセキュリティ対策が実装されていないため、慎重に扱ってください。

📚 ドキュメント

与 AI 助手集成

この MCP サーバーは、Model Context Protocol 互換の AI アシスタントと一緒に使用するように設計されています。以下は統合手順です。

1. VSCode 拡張機能のインストール：
   • VSCode を開きます。
   • 拡張機能ビューに移動します（Ctrl+Shift+X を押すか、メニューから「View」>「Extensions」を選択）。
   • 「VSCode Context MCP」拡張機能を検索してインストールします。
2. MCP サーバーの起動：
   • インストールが完了したら、ターミナルを開きます（Ctrl+Alt+T を押す）。
   • コマンドを入力します：npm start mcp-server
   • エンターキーを押してサービスを開始します。
3. AI アシスタントの設定：
   • AI アシスタントの設定で、MCP サーバーのアドレスとポートを指定します。
   • API キーまたは認証トークンが正しく設定されていることを確認して、サービスにアクセスします。

ツールリファレンス

以下は利用可能なコマンドとその説明です。

• get_vscode_context：現在の VSCode コンテキスト情報を取得します。
• list_directory：指定されたディレクトリ内のファイルとサブディレクトリを一覧表示します。
• create_directory：新しいディレクトリ構造を作成します。
• search_files：特定のパターンに一致するファイルを検索します。
• edit_file：行ベースでファイルを変更します。
• write_file：ファイルを作成または上書きします。
• move_file：ファイルやディレクトリを移動または名前を変更します。
• directory_tree：ディレクトリの再帰的な構造情報を取得します。

開発計画

1. 複数の VSCode プロジェクトをサポートする
2. ファイルの書き込み/編集の確認/取り消し機能
3. ユーザーインターフェイスの再設計

コントリビューション

コントリビューションを歓迎します！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でオープンソース化されています。詳細は LICENSE ファイルを参照してください。