mcpField
M
mcp-builder

mcp-builder

github.com/dkyazzentwatwa開発126190 回インストール30 週間前に更新
リポジトリ

mcp-builder について

一連のユーザーワークフローを軸にMCPサーバーを設計・実装するスキルです。API調査やツール設計から共通基盤の整備、実際の評価まで開発者を支援します。

主な機能

  1. 01ワークフローを軸にしたツール設計
  2. 02ツールスキーマと docstring
  3. 03認証とリクエスト用ヘルパー
  4. 04ページネーションと応答整形
  5. 05サーバー評価用リソース

活用シーン

  1. 01APIドキュメントからMCPツールを計画
  2. 02PythonまたはTypeScriptのMCPサーバーを構築
  3. 03エラーメッセージやツール出力を改善
  4. 04実際のタスクでサーバーの使いやすさを評価

MCP 対応

ツール一覧、入出力スキーマ、評価用プロンプトやスクリプトなど、MCPサーバーの作成を支援します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dkyazzentwatwa/chatgpt-skills --skill mcp-builder

インストール後、Claude Code で/mcp-builderを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE.txt
agents/
openai.yaml
references/
evaluation.md
mcp_best_practices.md
node_mcp_server.md
python_mcp_server.md
scripts/
connections.py
evaluation.py
example_evaluation.xml
requirements.txt

詳細

MCP ビルダー

生の API エンドポイントではなく、ユーザーのワークフローを中心に MCP サーバーを構築します。

ワークフロー

  1. 対象となる API のドキュメントを読み、エージェントが最初から最後まで完了する必要のあるワークフローを特定します。
  2. シグナルの高い出力、明確な識別子、次の行動につながるエラーを備えた、小規模なツール群を設計します。
  3. まず、認証、リクエストヘルパー、ページネーション、切り詰め、フォーマットなどの共通インフラを実装します。
  4. 正しい使い方が明確にわかるツールスキーマと docstring を追加します。
  5. 対象範囲を広げる前に、現実的なタスクを使ってサーバーを評価します。

原則

  • 薄いエンドポイントラッパーより、ワークフローに沿ったツールを優先します。
  • デフォルトでは、簡潔でシグナルの高い応答を返します。
  • 可能な限り、人が読みやすい識別子を使用します。
  • エラーメッセージは、エージェントに次に試すことを伝える、修正につながる内容にします。
  • 限られたコンテキストと大規模なデータセットを前提に設計します。

リソース

  • すべてのサーバーに適用される設計原則については、references/mcp_best_practices.md を参照してください。
  • Python の実装パターンについては、references/python_mcp_server.md を参照してください。
  • TypeScript の実装パターンについては、references/node_mcp_server.md を参照してください。
  • リポジトリ内のヘルパーとして、scripts/connections.py と scripts/evaluation.py を参照してください。

成果物

  • ユーザーのワークフローに対応付けられた、具体的なツール一覧。
  • 厳密な入出力スキーマ。
  • エージェントがサーバーを利用できることを確認する評価用プロンプトまたはスクリプト。

コメント

Markdown 対応