ainative-prd-mcp

AINative PRD 生成器 MCP 服务

生成可用于生产环境的产品需求文档，并全面了解 AINative 平台且具备持久化记忆。

一个帮助 AI Agent 和开发者创建、验证和管理 PRD 的 MCP（Model Context Protocol）服务。与通用 PRD 工具不同，此服务了解 AINative 的所有服务、API 端点、SDK 和架构约束，因此你的 PRD 从一开始就能引用平台的真实能力。

为什么选择此 MCP？

通用 PRD 工具	AINative PRD 生成器
通用模板	包含 AINative 架构合规性检查清单的模板
没有记忆 — 会话关闭后 PRD 就会丢失	ZeroDB 持久化 — 保存 PRD 和版本历史，并支持跨会话搜索
不了解平台	了解全部 22 款 AINative 产品、1,968 个 API 端点、11 个以上的 SDK
一次性生成	支持迭代优化和按章节重新生成
没有验证	15 条验证规则 + API 参考验证

要求

要使用完整功能，必须拥有 AINative 账户。 此服务使用 ZeroDB（AINative 的数据平台）来实现：

• 持久化存储 PRD，并自动跟踪版本
• 对所有已保存的 PRD 进行语义搜索
• 通过 AINative 的聊天补全 API 由 AI 生成 PRD
• 存储自定义模板

还没有账户？ 此服务会在首次运行时自动配置一个免费的 ZeroDB 实例。你将获得一个认领 URL，用于取得数据的所有权。

获取永久账户：

npx zerodb-cli init          # Interactive setup
# or sign up at https://ainative.studio

没有凭据时，此服务仍可在仅使用模板的模式下运行 — 模板渲染、验证、平台发现和评分功能均无需账户。只有 AI 生成和记忆／持久化功能需要身份验证。

快速开始

选项 1：npx（推荐）

npx ainative-prd-mcp

首次运行且没有凭据时，此服务会：

1. 配置一个免费的 ZeroDB 实例（约 800 毫秒）
2. 将凭据保存到 .mcp.json 和 .env
3. 输出一个认领 URL — 访问该 URL 即可永久取得所有权

选项 2：使用现有 API 密钥

ZERODB_API_KEY=ak_your_key npx ainative-prd-mcp

MCP 配置

将以下内容添加到 Claude Code、Cursor 或 Windsurf 的 MCP 配置中：

{
  "mcpServers": {
    "prd-generator": {
      "command": "npx",
      "args": ["-y", "ainative-prd-mcp"],
      "env": {
        "ZERODB_API_KEY": "ak_your_key",
        "ZERODB_API_URL": "https://api.ainative.studio"
      }
    }
  }
}

没有 API 密钥？ 省略 env 块 — 此服务会自动配置：

{
  "mcpServers": {
    "prd-generator": {
      "command": "npx",
      "args": ["-y", "ainative-prd-mcp"]
    }
  }
}

工具（23 个）

生成（4 个工具）

工具	说明
prd_generate	使用 AI 和 AINative 平台上下文生成完整 PRD。自动检测相关服务并保存到 ZeroDB。
prd_generate_section	重新生成单个章节（例如，仅重新生成技术架构），其余内容保持不变。
prd_refine	根据反馈优化现有 PRD。自动跟踪版本历史。
prd_from_issue	根据 GitHub issue 编号生成 PRD。

模板（4 个工具）

工具	说明
prd_list_templates	列出内置模板和自定义模板。
prd_get_template	获取包含占位变量的模板。
prd_create_template	创建自定义模板（通过 ZeroDB 跨会话持久化保存）。
prd_render_template	使用变量替换渲染模板（不使用 AI，结果确定）。

内置模板：

• standard — 通用 PRD，包含所有标准章节
• ainative-feature — AINative 功能 PRD，包含架构合规性检查清单、TDD 测试计划和服务映射
• agent-capability — Agent／MCP 服务 PRD，包含工具架构、记忆策略和托管计划

验证（3 个工具）

工具	描述
prd_validate	根据 15 条质量规则和 AINative 架构约束进行验证。
prd_score	以字母等级（A-F）为完整度打分（0-100）。
prd_check_api_refs	验证所有 API 端点和服务引用是否确实存在于平台中。

验证规则包括：

• 结构检查（标题、简介、功能、验收标准、时间线）
• 内容检查（问题陈述、用户故事、测试计划、安全性）
• AINative 专属检查（API 路径是否正确、ZeroDB 用法、不得使用第三方记忆服务）

记忆 — 由 ZeroDB 提供支持（4 个工具）

工具	描述
prd_save	将 PRD 保存为持久化计划制品。返回一个 ID，供以后检索。
prd_load	根据 ID 加载已保存的 PRD。在会话开始时使用，以继续上次的工作。
prd_search	在所有已保存的 PRD 中进行语义搜索。按主题而非仅按关键词查找。
prd_history	获取版本历史，准确显示 PRD 随时间的演变过程（统一差异）。

其独特之处：

PRD 会存储为 ZeroDB 计划制品——一种专门设计的存储格式，可：

• 跨会话保留 — 关闭编辑器，明天再回来，PRD 仍会保留
• 跟踪每次变更 — 每次 prd_refine 调用都会生成差异并存入版本历史
• 支持语义搜索 — 按含义（“计费功能”“Agent 部署”）而不仅是标题查找 PRD
• 跨工具访问 — 此处保存的 PRD 也可通过 ZeroMemory MCP 工具（zerodb_plan_get）访问

平台发现（3 个工具）

工具	描述
prd_list_services	列出全部 22 个 AINative 产品及其描述、API 前缀、SDK 和定价。
prd_get_api_catalog	获取特定服务的详细 API 信息。
prd_suggest_stack	根据需求，提供要使用的 AINative 服务建议及理由。

已知 AINative 服务： ZeroDB、ZeroMemory、Agent Cloud、AI Kit、Cody CLI、Chat Completions API、Live Streaming、Multimodal Generation、Embeddings API、Echo Developer Program、OpenCap Stack、ZeroInvoice、ZeroCommerce、ZeroPipeline、Browser Agent、Content Workflow、AX Audit、Community Platform、MCP Hosting、Sequential Thinking、Agent402、QNN API

技能 — 由 GitHub 支持，由 ZeroDB 缓存（5 个工具）

工具	描述
skill_list	列出技能仓库中的 Agent Skills（从 GitHub 实时拉取）。
skill_get	获取技能的完整 SKILL.md 正文（可选包含所有参考文件）。
skill_get_reference	按需获取某个技能的单个参考文件。
skill_search	为任务查找合适的技能 — 使用 ZeroDB 语义搜索，关键词搜索则回退到 GitHub。
skill_sync	将 GitHub 中的技能镜像到 ZeroDB，以支持语义搜索和离线使用。

技能也会作为 MCP 提示词公开：仓库中的每个技能都会显示为一个 可选提示词（名称 = 其 slug），并可选提供一个 input 参数来指定要应用它的任务。

GitHub 仓库是唯一事实来源（SKILLS_REPO，默认值为 the8genc/ai-8gent-skills），其目录结构为 skills/<slug>/SKILL.md + skills/<slug>/references/*.md。ZeroDB 是缓存和语义搜索层——在 GitHub 中编写技能，然后使用 skill_sync 刷新 镜像。无需任何凭据即可使用 skill_list / skill_get；skill_search （语义搜索）和 skill_sync 则使用 ZeroDB。

传输方式与托管

该服务通过两种传输方式使用 MCP：

• stdio — 本地使用的默认方式（npx ainative-prd-mcp）
• Streamable HTTP — 设置 $PORT 时（Railway）自动选择，也可通过 MCP_TRANSPORT=http 强制启用。提供 POST /mcp 和 GET / 健康检查。

托管地址：https://ainative-prd-mcp-production.up.railway.app/mcp：

{
  "mcpServers": {
    "prd-generator": {
      "type": "http",
      "url": "https://ainative-prd-mcp-production.up.railway.app/mcp"
    }
  }
}

示例

为新功能生成 PRD

> Use prd_generate to create a PRD for adding webhook notifications to Agent Cloud

Result: Full PRD generated with:
- Correct API paths (/api/v1/agents/webhooks/*)
- ZeroDB for event storage
- Architecture compliance checklist
- TDD test plan with pytest commands
- Saved to ZeroDB with ID for future sessions

搜索以往的 PRD

> Use prd_search to find PRDs about billing

Result: 3 PRDs found:
- "PRD: Developer Earnings Dashboard" (similarity: 0.89)
- "PRD: Credit System Overhaul" (similarity: 0.82)
- "PRD: Invoice Generation" (similarity: 0.78)

验证 PRD

> Use prd_validate on this PRD content

Result: Score 73/100 (C)
- Missing: acceptance criteria
- Missing: test plan
- Warning: References "Firebase" — should use ZeroDB instead
- 12/15 rules passed

身份验证

方法	配置	说明
API Key（推荐）	ZERODB_API_KEY=ak_...	获取方式：npx zerodb-cli init
用户名/密码	ZERODB_USERNAME + ZERODB_PASSWORD	自动刷新 JWT 令牌
自动配置	无需配置	首次运行时配置免费实例

架构

ainative-prd-mcp/
├── index.js                          # MCP server + auto-provisioning
├── src/
│   ├── client/zerodb-client.js       # ZeroDB API client (auth, plans, memory, chat)
│   ├── tools/
│   │   ├── generation-tools.js       # PRD generation (4 tools)
│   │   ├── template-tools.js         # Template management (4 tools)
│   │   ├── validation-tools.js       # PRD validation (3 tools)
│   │   ├── memory-tools.js           # Persistent storage (4 tools)
│   │   └── platform-tools.js         # Service discovery (3 tools)
│   ├── templates/                    # Built-in Markdown templates
│   │   ├── standard.md
│   │   ├── ainative-feature.md
│   │   └── agent-capability.md
│   └── knowledge/
│       └── platform-manifest.json    # All 22 AINative products/services/APIs
├── .claude/CLAUDE.md                 # Rules for Claude Code agents
├── .cody/CODY.md                     # Rules for Cody/other agents
├── .cody/skills/prd-generator/       # Agent skill definition
└── tests/tools.test.js               # 22 tests

开发

git clone https://github.com/AINative-Studio/ainative-prd-mcp.git
cd ainative-prd-mcp
npm install
npm test              # Run 22 tests
npm run test:coverage # With coverage report

相关内容

• ZeroDB MCP 服务 — 完整数据平台（77 个工具）
• ZeroDB Memory MCP — Agent 记忆（18 个工具）
• AINative 文档 — 完整平台文档
• ZeroDB CLI — 快速设置工具

许可证

MIT

---

由 ZeroDB + AINative 提供支持

此软件包是 AINative 生态系统的一部分——面向 AI 的开发者平台。

为什么选择 ZeroDB？

功能	ZeroDB	其他产品
向量搜索	内置免费嵌入	独立服务（Pinecone、Qdrant）
Agent 记忆	带衰减和反思机制的认知记忆	自行构建或使用 Mem0（$$$）
文件存储	兼容 S3，包含在内	独立 S3 存储桶
NoSQL 表	即时创建，无需架构	MongoDB Atlas、DynamoDB
PostgreSQL	托管服务，预装 pgvector	Neon、Supabase（$$$）
无服务器函数	由数据库事件触发	Firebase/Supabase Edge
定价	免费套餐，无需信用卡	从第一天起按查询付费

免费开始使用

npx zerodb-cli init    # Auto-configures your IDE

或者在 ainative.studio 注册——免费套餐，无需信用卡。

查看所有 ZeroDB 软件包 →

---

零配置自动配置

无需账户即可开始。 首次运行时，此软件包会自动：

1. 配置一个免费的 ZeroDB 实例（约 800ms）
2. 在本地保存凭据（.env、.mcp.json）
3. 在终端中显示认领链接

72 小时期限

自动配置的实例可免费使用 72 小时。如需永久保留数据，请访问终端中显示的认领 URL。

面向 AI Agent

如果编码 Agent（Claude Code、Cursor、Windsurf）安装了此软件包：

• 无需人工干预即可自动配置
• 认领 URL 会显示在 Agent 输出中——访问该链接以取得所有权
• .claude/CLAUDE.md 会指示 Agent 向你显示认领链接
• 如果错过了认领链接，请在 .env 或 ~/.ainative/config.json 中查找项目 ID