产品MCP服务器
用于管理遵循以下步骤的项目的MCP（模型上下文协议）服务器 产品.md 规范。
该存储库是一个单存储库，在人工智能模型和结构化项目文档之间架起了一座桥梁。
致谢
该项目建立在以下基础工作之上 基德库迪:
Monorepo结构
product-mcp：MCP服务器实现。pkg/product-go：用于解析和操作的分叉和集成参考Go库PRODUCT.md文件夹。
此服务器提供了一组工具，用于以编程方式读取、更新和验证您的项目文档，确保遵守规范，同时使AI代理能够充当有效的项目经理。
特性
- 集成图书馆：包括
product-go强大的Markdown解析引擎。 - 项目管理：初始化新项目，更新愿景，管理技术栈，定义范围。
- 零配置发现：自动从当前目录向上搜索以查找项目根目录。
- 目标跟踪：添加、列出和切换项目目标的完成状态。
- 域和功能管理：管理域和功能，支持内联和拆分文件(
domains/*.md)架构自动。 - 问题跟踪：在中创建、更新和列出问题
ISSUES.md具有自动递增的ID。 - 智能保存：智能更新正确的文件（主
PRODUCT.md与单个域文件相比），而不会丢失或复制数据。
安装
cd /home/crymfox/repos/CrymfoxLabs/product-repos/product-mcp
go build -o product-mcp使用和集成
自从 product-mcp 用途 上下文发现，您只需要全局配置一次。它将自动找到 PRODUCT.md 无论你打开哪个项目。
1.光标
- 打开 光标设置 (
Ctrl + Shift + J/Cmd + Shift + J). - 首选 特性 -> 主控程序.
- 点击 +添加服务器.
- 名字:
Product-Manager - 类型:
command - 命令:
/home/crymfox/repos/CrymfoxLabs/product-repos/product-mcp/product-mcp2.克劳德桌面
将此添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"product-mcp": {
"command": "/home/crymfox/repos/CrymfoxLabs/product-repos/product-mcp/product-mcp",
"args": []
}
}
}3.Gemini CLI
将服务器添加到您的配置中：
{
"mcpServers": {
"product": {
"command": "/home/crymfox/repos/CrymfoxLabs/product-repos/product-mcp/product-mcp"
}
}
}代理配置
为了获得最佳结果，请将以下说明添加到您的编码代理中（例如。， .cursorrules, .agent或系统提示）。
项目管理协议
作为参与此项目的代理人，您必须遵守以下工作流程，以确保 PRODUCT.md 和 ISSUES.md 仍然是“唯一的真理来源”
1.发现与背景
- “第一眼”规则：在编写任何代码或提出计划之前，运行
project_summary. - 域名审核：阅读
list_domains以及后续的领域详细信息，以了解现有功能的“为什么”和“验收标准”。 - 待办事项检查：运行
list_issues status:open查看您的任务是否已被跟踪。
2.操作规程（“同步”规则）
- 任务开始:
- 将相关问题过渡到 status: in-progress 使用 update_issue. - 将关联功能设置为 state: building 使用 update_feature_state.
- 实施:
- 如果添加库，请运行 manage_tech_stack. - 如果添加新的子文件夹或模块，请运行 manage_scopes. - 验收跟踪：当您满足个人要求时，请使用 toggle_feature_acceptance 将它们标记为已完成。 - 范围蠕变/变化：如果要求发生变化，请使用 set_feature_acceptance 以更新标准。
- 完成:
- 确保所有验收标准都标记为已完成。 - 将问题设置为 status: closed 并提供简洁明了的 fix 描述。 - 将功能设置为 state: ready. - 如果目标完全满足，请使用 toggle_goal done:true.
3.文件标准
- 领域：始终使用
as_file: true添加要保留的域时PRODUCT.md可读性。 - 可追溯性：每个功能都必须属于一个域。每个问题都应该与一个功能相关。
______________________________________________________________________
工具
项目
project_init：初始化新的项目结构。project_summary：获取高级统计数据和进度。update_vision更新中心愿景声明。manage_tech_stack：添加/更新图层和技术。manage_scopes：管理项目目录及其执行状态。
目标
list_goals：列出所有目标及其状态。add_goal：添加新的项目目标。toggle_goal：将目标标记为已完成/待定。
领域
list_domains：列出所有域及其位置。add_domain：添加新域(as_file: true推荐）。add_feature：添加一个包含状态、原因和验收标准的功能。update_feature_state：过渡功能（愿景->构建->准备就绪）。set_feature_acceptance：覆盖功能的验收标准列表。toggle_feature_acceptance：将特定的验收标准标记为已完成或待定。
问题
list_issues：从中筛选并列出问题ISSUES.md.create_issue：创建新问题（自动生成ISSUE-NNN).update_issue：更新状态或记录修复。
项目结构
main.go：MCP服务器的入口点。tools/：MCP工具定义和处理程序。pkg/product-go/：PRODUCT.md规范参考Go库。
许可证
______________________________________________________________________
Built with ❤️ by Crymfox Labs