| name | mcp-builder |
| description | Guide for creating MCP (Model Context Protocol) servers that enable LLMs to interact with
external services through well-designed tools.
Triggers: 「MCPサーバーを作成」「外部API連携」「ツール統合」「MCP開発」
Use when: Building MCP servers to integrate external APIs or services.
Recommended stack: TypeScript + MCP SDK
|
MCP Server Development Guide
MCPサーバーの設計・実装ガイド。LLMが外部サービスとやり取りするためのツールを提供する。
High-Level Workflow
Phase 1: Deep Research and Planning
- MCP仕様の確認:
https://modelcontextprotocol.io/sitemap.xml から関連ページを確認
-
- SDK確認: TypeScript SDK (
https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/v0.6.0/README.md)
-
- API理解: 対象サービスのAPIドキュメントを調査
-
- ツール設計: 実装するエンドポイントをリストアップ
Phase 2: Implementation
プロジェクト構造（TypeScript推奨）
mcp-server-xxx/
├── src/
│ ├── index.ts # サーバーエントリーポイント
│ ├── tools/ # ツール定義
│ ├── types/ # 型定義
│ └── utils/ # ユーティリティ
├── package.json
└── tsconfig.json
ツール実装のポイント
- Input Schema: Zodでバリデーション、制約と説明を含める
- Output Schema:
outputSchema で構造化データを定義
- Description: 機能の簡潔なサマリー + パラメータ説明
- Error Handling: アクション可能なエラーメッセージ（次のステップを提案）
Annotations
{
annotations: {
title: 'List all users',
readOnlyHint: true,
destructiveHint: false,
idempotentHint: true,
openWorldHint: true,
},
}
Phase 3: Review and Test
npm run build でコンパイル確認- MCP Inspectorでテスト:
npx @modelcontextprotocol/inspector@0.19.0
- コード品質チェック: DRY、一貫したエラーハンドリング、型カバレッジ
Phase 4: VS Code統合
.vscode/mcp.json に設定を追加:
{
"servers": {
"your-server": {
"command": "npx",
"args": ["-y", "your-mcp-server-package"]
}
}
}
Design Principles
- Tool Naming: 一貫したプレフィックス（例:
github_create_issue）
- Context Management: 簡潔なツール説明、フィルタ/ページネーション対応
- Error Messages: エージェントを解決に導く具体的な提案
- API Coverage: ワークフローツールよりも包括的なAPI網羅を優先
Resources
