MCP Server - VSCode Tutorial

チュートリアル：Visual Studio Code で 2 つの MCP サーバーを実行する

Go で MCP サーバーを構築してデプロイし、Node の MCP サーバーをデプロイして、Visual Studio Code を MCP クライアントとして使用するチュートリアルです。

概要

2025 年 4 月現在、ほとんどの MCP チュートリアルやデモは、Claude Desktop アプリケーションを対象としています。ただし、Agent モードの GitHub Copilot があれば、Visual Studio Code を MCP クライアントとして使用して開発やテストを行うこともできます。

MCP サーバーはさまざまな言語で作成されています。このガイドでは、2 つの MCP サーバーを実装します。1 つは Go、もう 1 つは Node（bun.sh）です。Go の MCP サーバーは mcp-go パッケージをベースにしており、Go サーバーはそのパッケージのリポジトリにあるサンプルの 1 つをベースにしています。Node パッケージは、テーブルスキーマを取得するために私が開発しているものです。

MCP サーバーとは

MCP（Model Context Protocol）サーバーは、標準化された Model Context Protocol を通じて特定の機能を公開するために設計された軽量プログラムです。このプロトコルにより、アプリケーションは大規模言語モデル（LLM）にコンテキストを安全かつ効率的に提供できます。

MCP サーバーは、LLM とローカルおよびリモートのさまざまなデータソースやツールをつなぐ橋渡し役と考えてください。LLM がファイル、データベース、API、その他のサービスに、制御された方法でアクセスして操作できるようにします。これにより、複雑なワークフローを構築し、AI モデルをさまざまなシステムと統合しやすくなります。

参考資料：

• MCP の概要

要件

• Visual Studio Code
• Agent モードの Github Copilot
• Go の知識と Go のインストール
• Node（または bun.sh）の知識と Node または bun のインストール

Windows でサーバーを構築してデプロイする

Go サーバーを構築する

MCP Go パッケージ

テストには、次のサンプルコードを使用しました。

• Go パッケージ：mcp-go
• サーバーコード：mcp-go/examples/everything

Go サーバーを構築する

• このリポジトリをクローンします
• ディレクトリを server に変更します
• 必要なパッケージを取得します：go mod tidy
• MCP サーバーをビルドします：go build .
• 実行ファイルの完全なパスをコピーします：C:\Users\user\git\msalemor\mcp-vscode-tutorial\go-server\mcpgo.exe

Go サーバーをデプロイする

• Github Copilot Chat を開きます

• Copilot を Agent モードに変更します

• 

• Agent ペインで、Tools をクリックします

• 上部バーのポップアップで + Add More Tools をクリックします

• 

• 上部バーのポップアップで + Add MCP Server をクリックします

• 

• 上部バーのポップアップで Command (stdio) を選択します

• 

• 実行するコマンドに、Go 実行ファイルの完全なパスを貼り付けます

• サーバーに任意の名前を付けます

• MCP の設定をユーザー（グローバル）設定またはワークスペース（プロジェクトのみ）設定として保存します

• ワークスペースを選択すると、Visual Studio により .vscode/mcp.json に次の設定が生成されます

{
    "servers": {
        "mcpgo1": {
            "type": "stdio",
            "command": "C:\\Users\\user\\git\\msalemor\\mcp-vscode-tutorial\\go-server\\mcpgo.exe",
            "args": []
        }
    }
}

• サーバーを起動します
• 
• 他のツールを追加していない場合、VSCode に 5 つのツールが表示されます

Node サーバーをデプロイする

• .vscode/mcp.json ファイルを開きます
• 次のように Node の bun-server MCP 設定を追加します：

• 注：node の代わりに bun.sh を使用しています

{
    "servers": {
        "mcpgo-server": {
            "type": "stdio",
            "command": "C:\\Users\\user\\git\\msalemor\\mcp-vscode-tutorial\\go-server\\mcpgo.exe",
            "args": []
        },
        "bun-server": {
            "type": "stdio",
            "command": "bun", // change to Node if using node and do not add this comment
            "args": [
                "run",
                "C:\\Users\\user\\git\\msalemor\\mcp-vscode-tutorial\\node-server\\index.ts"
            ]
        }
    }
}

サーバーを実行する

• 両方のサーバーが実行中であることを確認します
• 
• 実行中でない場合は、start をクリックします

サーバーをテストする

• types.go という名前のファイルを作成します
• ファイルが Agent のコンテキストに含まれていることを確認します
• エージェントに次のように入力します：Get the table schema for users. Create a structure for the schema. Notify the user when done.

期待される結果

サーバーの実行中

スクリーンショットでは、MCP サーバーが実行中で、VSCode に 6 つのツールが登録されていることがわかります。また、Agent が 2 つのツールを使用して、users スキーマに基づく Go の types.go ファイルを作成したことも確認できます。

サンプルクエリと結果

• エージェントウィンドウに次のように入力します：Get the table schema for users. Create a structure based on the schema. Notify the user when done.
• Enter キーを押します

結果