Mcp Cookbook

🍳 MCP Cookbook

一个 MCP（Model Context Protocol）服务，为 AI 编码助手提供常见开发任务的分步食谱和流程。从项目设置和配置到部署模式，mcp-cookbook 为你的 AI 工具提供知识，帮助你高效地遵循标准工作流。

非常适合希望在不同项目中采用一致、可重复流程的团队，以及希望借助 AI 加快常见开发任务的开发者。

示例用法

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

请参阅 .cookbook/cookbook-1.md，查看遵循以下约定的结构完善的 cookbook 完整示例。

更多流程示例：即将推出

运行

适用于 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 设置为你的项目目录，或全局 cookbooks 文件夹，因为文件将从该位置加载。

使用场景

MCP Cookbook 非常适合规范化并自动化常见开发工作流。以下是一些适合通过结构化 cookbook 实现的流程示例：

后端开发

• 添加新的 API 控制器 - 规范文件结构、路由、验证和测试模式
• 设置邮件通知 - 配置模板、文档和示例数据
• API 版本管理 - 创建新的 API 版本，并包含旧版本

前端开发

• 创建新的 UI 组件 - 设置组件文件、故事、测试和文档
• 添加 Storybook 故事 - 根据规范生成带有适当控件和文档的组件故事
• 设置新页面／路由 - 创建页面组件、路由配置和导航
• 实现响应式布局 - 添加断点指南以及 CSS 类辅助工具
• 添加表单验证 - 描述表单验证要求

代码质量与重构

• 重构组件 - 描述并制定从一种格式重构为另一种格式的流程

测试与质量保证

• 为新功能添加单元测试 - 规范测试文件结构、模拟模式和断言策略

这些 cookbook 可确保 AI 编辑器之间的一致性，并执行更复杂的规则，供开发者参考或应用。

Cookbooks

Cookbook 是包含常见开发任务分步流程和食谱的 Markdown 文件。它们存储在项目目录的 .cookbook/ 中，并遵循特定结构，以确保一致性和易于发现。

注意：项目中的库也可以拥有自己的 cookbooks。

编写 Cookbook

每个 cookbook 都是带有元数据 frontmatter 的 Markdown 文件。创建方法如下：

1. 文件结构

• 将 cookbook 放入 .cookbook/ 目录
• 使用描述性文件名，并以 .md 结尾

2. Frontmatter

每个 cookbook 都必须以包含以下内容的 YAML frontmatter 开头：

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

• name：cookbook 完整且易读的标题
• short：便于快速引用的简短标识符／代码
• description：对 cookbook 用途的简洁说明

你的大模型会使用这些信息，在项目中搜索 cookbooks。

3. 内容结构

使用以下内容组织 cookbook：

• 清晰的章节标题（##、###）
• 流程的编号步骤
• 用于命令和示例的代码块
• 用于补充说明或要求的项目符号

MCP 函数

以下是我们提供给大模型的 MCP 函数。

search_cookbook

搜索找到的所有 cookbooks，提供相关 cookbook 列表（前 50 个），并返回名称和描述。

read_cookbook

向大模型提供单个 cookbook 的内容以供其完成任务，不包含 frontmatter。