MCP Builder Skill

概要

MCP Builder Skillは、AnthropicのオフィシャルClaude Skillsの1つで、LLMが適切に設計されたツールを通じて外部サービスと対話できるようにする高品質なMCP (Model Context Protocol) サーバーの作成を指導するために設計されています。この包括的なスキルは、Python(FastMCPを使用)またはNode/TypeScript(MCP SDKを使用)でMCPサーバーを構築するための完全なフレームワークを提供します。

このスキルには、広範なドキュメント、ベストプラクティス、研究と計画から実装、テスト、評価作成までをカバーする構造化された4段階の開発プロセスが含まれています。MCPサーバーの品質は、LLMが実際のタスクをどれだけ効果的に達成できるかで測定されます。

コア機能

1. モダンなMCPデザイン原則

包括的なガイダンス:

• APIカバレッジ vs. ワークフローツール: 包括的なエンドポイントと専門的なワークフローのバランス
• ツールの命名と発見可能性: 一貫したプレフィックスを持つ明確で説明的な命名
• コンテキスト管理: 簡潔な説明と焦点を絞った関連データ
• アクション可能なエラーメッセージ: 具体的な提案を含むソリューションへのガイダンス

2. 4段階の開発プロセス

フェーズ1: 深い研究と計画

• モダンなMCPデザインパターンの理解
• MCPプロトコルドキュメントの学習
• フレームワーク固有のパターンの学習
• 実装戦略の計画

フェーズ2: 実装

• プロジェクト構造のセットアップ
• コアインフラ(APIクライアント、エラー処理、ページネーション)
• 適切なスキーマでツールを実装
• 出力スキーマと構造化コンテンツのサポート

フェーズ3: レビューとテスト

• コード品質レビュー(DRY、エラー処理、型)
• ビルド検証
• MCP Inspectorでテスト
• 言語固有の品質チェック

フェーズ4: 評価の作成

• 10個の複雑で現実的な評価質問
• 読み取り専用で検証可能なテストケース
• 自動テスト用のXMLフォーマット

3. 包括的なドキュメントライブラリ

以下へのアクセスを含む:

• MCPプロトコル仕様: 完全なプロトコルドキュメント
• ベストプラクティスガイド: ユニバーサルMCPガイドライン
• Pythonガイド: 完全なFastMCP実装パターン
• TypeScriptガイド: 完全なMCP SDK実装パターン
• 評価ガイド: 効果的なテストケースの作成

4. ツール実装のベストプラクティス

ツール作成のガイダンス:

• 入力スキーマ: Zod (TypeScript) または Pydantic (Python) を使用
• 出力スキーマ: クライアント処理用の構造化データ定義
• 説明: パラメータドキュメントを含む簡潔なサマリー
• アノテーション: readOnlyHint、destructiveHint、idempotentHint、openWorldHint
• エラー処理: 具体的なガイダンスを含むアクション可能なメッセージ

5. フレームワークサポート

両方のエコシステムを完全サポート:

• TypeScript: streamable HTTPまたはstdioトランスポートを使用したMCP SDK
• Python: streamable HTTPまたはstdioトランスポートを使用したFastMCP

使用ケース

• API統合: LLMを外部サービス(GitHub、Slack、データベース)に接続
• カスタムツール: 内部システム用の専門ツールの構築
• データアクセス: LLMが外部データをクエリおよび取得できるようにする
• サービスオーケストレーション: 複数の外部サービスを調整
• ワークフロー自動化: 一般的なタスク用の高レベルワークフローツールを作成

技術実装

推奨スタック

• 言語: TypeScript(互換性とAIコード生成に推奨)
• トランスポート: リモートサーバーにはStreamable HTTP、ローカルサーバーにはstdio
• ステートレスJSON: スケールと保守が容易

Python実装

• フレームワーク: Python SDK / FastMCP
• スキーマ検証: Pydanticモデル
• ツール登録: @mcp.tool デコレータ
• エラー処理: Python例外パターン

TypeScript実装

• フレームワーク: MCP SDK
• スキーマ検証: Zodスキーマ
• ツール登録: server.registerTool
• 構造化コンテンツ: リッチレスポンス用のモダンSDK機能

開発ワークフロー

1. 研究フェーズ: MCPドキュメント、フレームワークドキュメント、APIドキュメントを学習
2. 計画フェーズ: 実装するツールを選択、スキーマを設計
3. 実装フェーズ: サーバーインフラとツールを構築
4. テストフェーズ: MCP Inspectorで検証、品質をチェック
5. 評価フェーズ: 10個の現実的なテスト質問を作成

品質基準

このスキルは、サーバーが高品質基準を満たすことを保証:

• 重複コードなし(DRY原則)
• 一貫したエラー処理
• 完全な型カバレッジ
• 明確で簡潔なツール説明
• 包括的なAPIカバレッジ
• アクション可能なエラーメッセージ
• 適切なアノテーション

評価作成

効果的な評価を作成するための詳細ガイドを含む:

• 10個の複雑な複数ステップの質問
• 読み取り専用操作のみ
• 独立した検証可能な回答
• 時間の経過とともに安定
• 実際のユースケースに基づく
• 自動化用のXMLフォーマット

参照ドキュメント

このスキルは以下へのアクセスを提供:

• MCPプロトコル仕様(modelcontextprotocol.ioから)
• MCPベストプラクティス(mcpbestpractices.md)
• TypeScript実装ガイド(nodemcpserver.md)
• Python実装ガイド(pythonmcpserver.md)
• 評価ガイド(evaluation.md)

まとめ

MCP Builder Skillは、LLMが外部サービスと効果的に対話できるようにする高品質なMCPサーバーを作成するための権威あるガイドです。包括的なドキュメント、構造化されたプロセス、PythonとTypeScript実装の両方のベストプラクティスを通じて、このスキルはMCPサーバーが適切に設計され、徹底的にテストされ、LLMが実際のタスクを効率的に達成できることを保証します。