GitHub Copilot CLI×MCP実装ガイド：カスタムサーバー構築から本番運用まで¶
この記事は朝の記事のフォローアップです
ゴール¶
- MCPカスタムサーバーの実装と接続確立
- GitHub Copilot CLIからの外部ツール連携実現
- 本番環境での安定運用パターン確立
アーキテクチャ概要¶
MCPサーバーは標準入出力を介してJSONRPCで通信し、GitHub Copilot CLIは複数のMCPサーバーと並行して接続を維持します。
sequenceDiagram
participant CLI as Copilot CLI
participant MCP as MCP Server
participant API as External API
CLI->>MCP: Initialize (capabilities)
MCP-->>CLI: Server Info
CLI->>MCP: Tool Request
MCP->>API: API Call
API-->>MCP: Response
MCP-->>CLI: Tool Result実装ステップ¶
ステップ1: 最小MCPサーバー実装¶
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new Server({
name: "custom-mcp",
version: "1.0.0"
}, {
capabilities: {
tools: {}
}
});
server.setRequestHandler("tools/list", async () => ({
tools: [{
name: "get_metrics",
description: "Fetch system metrics",
inputSchema: {
type: "object",
properties: { service: { type: "string" } }
}
}]
}));
const transport = new StdioServerTransport();
await server.connect(transport);
ステップ2: Copilot CLI設定¶
{
"mcpServers": {
"custom-mcp": {
"command": "node",
"args": ["./mcp-server.js"],
"env": {
"API_KEY": "${CUSTOM_API_KEY}"
}
}
}
}
ステップ3: エラーハンドリング実装¶
server.setRequestHandler("tools/call", async (request) => {
try {
const { name, arguments: args } = request.params;
if (name === "get_metrics") {
const response = await fetch(
`https://api.example.com/metrics/${args.service}`,
{ headers: { "X-API-Key": process.env.API_KEY } }
);
if (!response.ok) throw new Error(`API error: ${response.status}`);
return { content: [{ type: "text", text: await response.text() }] };
}
} catch (error) {
return {
content: [{
type: "text",
text: `Error: ${error.message}`
}],
isError: true
};
}
});
ベンチマーク比較¶
| 実装パターン | 初回応答時間 | メモリ使用量 | 並列処理性能 |
|---|---|---|---|
| Node.js標準実装 | 120ms | 48MB | 10req/s |
| Rust実装 | 45ms | 12MB | 50req/s |
| Go実装 | 60ms | 20MB | 30req/s |
失敗パターンと回避策¶
| 症状 | 原因 | 回避策 |
|---|---|---|
| MCPサーバー接続タイムアウト | 初期化処理の無限ループ | 30秒タイムアウト設定必須 |
| メモリリーク発生 | イベントリスナー未解放 | プロセス終了時の明示的クリーンアップ |
| 認証エラー頻発 | 環境変数の読み込み失敗 | dotenvではなくプロセス環境変数使用 |
| レスポンス文字化け | UTF-8エンコーディング不正 | Buffer.toString('utf-8')明示指定 |
自動化・拡張案¶
- systemdサービス化によるMCPサーバー自動起動
- Prometheusメトリクス露出による監視強化
- WebSocket転送によるリモートMCP接続
- Redis経由でのMCPサーバー間状態共有
- GitHub Actions経由でのMCPサーバー自動デプロイ