Mcp Cookbook

🍳 MCP クックブック

AI コーディングアシスタントに、一般的な開発タスクの手順やレシピを段階的に提供する MCP（Model Context Protocol）サーバーです。プロジェクトのセットアップや設定からデプロイのパターンまで、mcp-cookbook は標準的なワークフローを効率よく進めるための知識を AI ツールに提供します。

プロジェクトや開発者間で一貫性のある、再現可能なプロセスを実現したいチームや、AI アシスタンスによって一般的な開発タスクを効率化したい開発者に最適です。

使用例

Following procedure parserfunc1 : Add a new parser function in the libs folder

規約に沿って適切に構成されたクックブックの完全な例については、.cookbook/cookbook-1.md を参照してください。

手順のその他の例：近日公開

実行方法

Cursor の場合：

{
  "mcpServers": {
    "mcp-cookbook": {
      "command": "npx",
      "args": ["-y", "@mikevalstar/mcp-cookbook"],
      "env": {
        "COOKBOOK_ROOT": "/Users/username/projects/mcp-cookbook"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-cookbook": {
      "command": "node",
      "args": ["/Users/username/projects/mcp-cookbook/build/index.js"],
      "env": {
        "COOKBOOK_ROOT": "/Users/username/projects/mcp-cookbook"
      }
    }
  }
}

COOKBOOK_ROOT をプロジェクト、またはグローバルなクックブックフォルダーに設定してください。そこからファイルが読み込まれます。

使用例

MCP Cookbook は、一般的な開発ワークフローの標準化と自動化に最適です。構造化されたクックブックが役立つ手順の例を以下に示します。

バックエンド開発

• 新しい API コントローラーの追加 - ファイル構成、ルーティング、バリデーション、テストのパターンを標準化します
• メール通知のセットアップ - テンプレート、ドキュメント、サンプルデータを設定します
• API のバージョン管理 - 新しい API バージョンを作成し、以前のバージョンも含めます

フロントエンド開発

• 新しい UI コンポーネントの作成 - コンポーネントファイル、ストーリー、テスト、ドキュメントを用意します
• Storybook ストーリーの追加 - 仕様に沿った適切なコントロールとドキュメントを備えたコンポーネントストーリーを生成します
• 新しいページ／ルートのセットアップ - ページコンポーネント、ルーティング設定、ナビゲーションを作成します
• レスポンシブレイアウトの実装 - ブレークポイントのガイドラインと CSS クラスヘルパーを追加します
• フォームバリデーションの追加 - フォームバリデーションの要件を記述します

コード品質とリファクタリング

• コンポーネントのリファクタリング - ある形式から別の形式へリファクタリングする手順を記述して定めます

テストと品質保証

• 新機能のユニットテストの追加 - テストファイルの構成、モックのパターン、アサーションの方針を定めます

これらのクックブックにより、AI エディター間の一貫性を保ち、開発者が適用・参照できる、より複雑なルールを徹底できます。

クックブック

クックブックは、一般的な開発タスクの手順やレシピを段階的に記載した Markdown ファイルです。プロジェクトディレクトリの .cookbook/ に保存され、一貫性と見つけやすさを確保するための特定の構成に従います。

注：プロジェクト内のライブラリが独自のクックブックを持つこともできます。

クックブックの作成

各クックブックは、レシピのメタデータを記載したフロントマターを含む Markdown ファイルです。作成方法は次のとおりです。

1. ファイル構成

• クックブックを .cookbook/ ディレクトリに配置します
• 内容が分かりやすいファイル名を付け、末尾を .md にします

2. フロントマター

各クックブックの先頭には、次の内容を含む YAML フロントマターを記載します。

---
name: Descriptive Name of the Recipe
short: shortcode
description: A brief description of what this cookbook accomplishes
---

• name：クックブックの、人に分かりやすい正式なタイトル
• short：すぐに参照できる短い識別子／コード
• description：クックブックの目的を簡潔に説明する文

これらはすべて、LLM がプロジェクト内のクックブックを検索する際に使用されます。

3. コンテンツの構成

クックブックの内容は、次の要素を使って整理します。

• 分かりやすいセクション見出し（##、###）
• 手順には番号付きステップ
• コマンドや例にはコードブロック
• 補足や要件には箇条書き

MCP 関数

以下は、LLM に提供する MCP 関数です。

search_cookbook

見つかったすべてのクックブックを検索し、関連するクックブックの一覧（先頭から 50 件）を提示して、名前と説明を返します。

read_cookbook

単一のクックブックを読み込み、LLM が手順を完了できるようにします。フロントマターは含まれません。