mcp-builder

mcp-use で構築する

インストール済みの mcp-use パッケージ、そのエクスポート型、生成された宣言、プロジェクトの既存コードを信頼できる情報源として扱ってください。API を選択したりコードを変更したりする前に、インストール済みのバージョンを確認してください。

ワークフロー

1. package.json、サーバーのエントリーポイント、エクスポートされたツール参照、mcp-env.d.ts、views/、skills/、インストール済みの mcp-use のバージョンを確認します。
2. create-mcp-use-app@latest と適切なテンプレートを使用して、新しい安定版プロジェクトをスキャフォールドします。ベータ版、カナリア版、または既存のバージョン指定プロジェクトで作業する場合は、パッケージのバージョンまたは dist-tag を合わせます。
3. タスクに必要なリファレンスだけを読みます。
   • ツール、リソース、プロンプト、MCP ミドルウェア、リクエストコンテキスト、結果エンベロープについては、Server を参照します。
   • インタラクティブな MCP Apps、React フック、モデルコンテキスト、ホスト機能、アセット、CSP については、Views を参照します。
   • OAuth プロバイダー、検証済みの ID、スコープ、権限、認可については、Authentication を参照します。
   • サーバーのツールとともに再利用可能なワークフローを提供する場合は、Skills over MCP を参照します。
   • OpenAPI、プロキシ、通知、サブスクリプション、入力要求については、Advanced features を参照します。
   • 廃止済みまたは互換性維持のみのインポート、ヘルパー、登録形式、UI パターン、セッションの前提が存在する場合に限り、Migration を参照します。
   • 実装作業の完了を報告する前に、Verification を参照します。
4. インストール済みの型に沿って実装します。コピーしたサンプルや過去の変更履歴より、フレームワークの現在の規約を優先してください。
5. 変更した動作を実証できる、最小限の実際のライフサイクルを検証し、リスクに応じてチェックを拡張します。

中核となる不変条件

• サーバー API は mcp-use から、React API は mcp-use/react から、OAuth プロバダーアダプターは mcp-use/oauth/* サブパスからインポートします。
• ツールの引数は inputSchema で定義します。構造化結果を返す場合、および View に関連付けるすべてのツールには outputSchema を追加します。
• MCP の結果エンベロープをそのまま返します。スキーマに基づくツールが成功した場合は、一致する structuredContent を含める必要があります。想定内の失敗では、モデルが読み取れる content とともに isError: true を返すことができます。
• 各 View は views/<name>/view.tsx に配置し、view: { name: "<name>" } で関連付けます。
• View が使用する、静的に宣言されたすべてのツール参照をエクスポートします。mcp-use dev、build、start で使用するサーバーのエントリーポイントをデフォルトエクスポートします。
• ID と変更可能なワークフロー状態は、リクエストスコープまたは外部ストアで管理します。クライアントが報告するメタデータは未検証として扱います。
• サーバーが、ツールの説明を肥大化させてしまうような再利用可能で複数ステップのワークフローを公開する場合は、Skills over MCP を検討してください。

ガードレール

• エクスポート、設定フィールド、コールバックの形式を推測で作らないでください。不確かな点は、インストール済みの宣言またはソースで確認します。
• 既存プロジェクトに記載されているという理由だけで、インストール済みのバージョンに存在しない API を残さないでください。
• ツールのコールバックから、プレーンなドメインオブジェクトを返さないでください。
• 対応する outputSchema と structuredContent の結果なしに View を関連付けないでください。
• リクエストをまたぐ ID、入力要求の継続性、永続的なビジネス状態の管理に、モジュールグローバルを使用しないでください。
• 型、パッケージのエクスポート、認証、インタラクティブな動作に変更があった場合、ソースのビルドだけで成功したと判断しないでください。
• ユーザーから明示的な依頼がない限り、デプロイしたり外部システムを変更したりしないでください。