MCP Server Extension

MCP サーバー拡張機能

GitHub Copilot がツールを検出できるよう、MCP サーバーを自動的に起動するシンプルな VS Code 拡張機能です。

機能

• 拡張機能の読み込み時に MCP サーバーを自動起動します
• GitHub Copilot 用のツールを3つ内蔵しています
• 設定は不要です

利用可能なツール

• add_numbers - 2つの数値を加算します
• get_weather - 天気予報を取得します（シミュレーション）
• list_files - ディレクトリ内のファイルを一覧表示します

インストール

オプション1：ビルド済み拡張機能をダウンロードする

1. リリースまたはこのリポジトリから、最新の.vsixファイルをダウンロードします
2. VS Codeを開きます
3. Ctrl+Shift+P（MacではCmd+Shift+P）を押して、コマンドパレットを開きます
4. 「拡張機能：VSIX からインストール...」と入力し、選択します
5. ダウンロードした.vsixファイルを参照して選択します
6. プロンプトが表示された場合は、VS Codeを再起動します

オプション2：ソースからビルドする

1. このリポジトリをクローンします：

   git clone https://github.com/ranjanbinwani/mcp-server-extension.git
   cd mcp-server-extension
   

2. VS Code Extension Managerをインストールします（まだインストールされていない場合）：

   npm install -g vsce
   

3. 拡張機能をパッケージ化します：

   vsce package
   

4. オプション1の手順に従って、生成された.vsixファイルをインストールします

使用方法

1. 拡張機能をインストールする - VS Codeの起動時に、拡張機能が自動的に設定されます
2. インストール後にVS Codeを再起動する - 正しく設定されていることを確認します
3. GitHub Copilot Chatを開く
4. 次のような質問をします：
   • 「15と27を足して」
   • 「ニューヨークの3日間の天気予報は？」
   • 「現在のディレクトリ内のファイルを一覧表示して」

GitHub Copilotは、MCPプロトコルを通じてツールを自動的に検出して使用します。

仕組み

拡張機能は次の処理を自動的に行います：

• 必要なPython依存関係（fastmcp）をインストールします
• GitHub Copilotが検出できるようにMCPサーバーを設定します
• 適切なMCP設定ファイルを作成します
• stdioプロトコルを通じてツールを利用可能にします

トラブルシューティング

GitHub Copilotがツールを検出しない場合：

1. VS Codeを完全に再起動する
2. Pythonのインストールを確認する - Python 3.xがPATHで利用可能であることを確認します
3. 手動で設定する - 拡張機能は次の場所に設定ファイルを作成します：
   • %USERPROFILE%\.vscode\mcp_servers.json
   • %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json
4. サーバーを単独でテストする：

   python mcp_server.py
   

   サーバーが起動し、stdioからの入力を待機するはずです。

要件

• Python 3.x（PATHに設定されていること）
• VS Code 1.80.0+
• GitHub Copilot拡張機能
• ビルドする場合：Node.jsとnpm

開発とビルド

拡張機能を変更する

1. コードを変更する - 必要に応じてextension.js、mcp_server.pyなどのファイルを編集します
2. 変更をテストする：
   • VS CodeでF5を押し、Extension Development Hostウィンドウを開きます
   • 新しいウィンドウで拡張機能の動作をテストします
3. バージョン番号を更新する：
   • package.jsonのversionフィールドをインクリメントします
   • サーバーを変更した場合は、mcp_server.pyのserver_versionを更新します
4. 拡張機能をビルドする：

   vsce package
   

   変更内容を含む新しい.vsixファイルが作成されます
5. 上記のインストール手順に従って、新しい.vsixファイルをインストールしてテストする

新しいツールを追加する

mcp_server.pyを編集して、独自のツールを追加します：

@server.tool()
def my_custom_tool(param: str) -> str:
    """Description of what your tool does."""
    return f"Processed: {param}"

ツールを追加した後：

1. ファイルを保存する
2. Pythonサーバーを単独でテストする：python mcp_server.py
3. 拡張機能を再ビルドする：vsce package
4. 更新した.vsixファイルを再インストールする
5. MCP設定を再読み込みするために、VS Codeを再起動する

変更を公開する

1. リポジトリを更新する：

   git add .
   git commit -m "Description of your changes"
   git push origin main
   

2. ユーザーが最新バージョンをダウンロードできるように、コミットに.vsixファイルを含めます
3. 主要な更新の場合は、（任意で）リリースを作成します：
   • GitHubリポジトリに移動します
   • 「Releases」→「Create a new release」をクリックします
   • リリースアセットとして.vsixファイルをアップロードします

ライセンス

MIT