ProduckAI MCP服务器
    
使用人工智能分析和无缝的Claude Desktop集成，将分散的客户反馈声音转化为可操作的见解。
🌟 什么是ProduckAI？
ProduckAI MCP服务器 将企业级产品反馈分析直接引入您的人工智能工作流程。与Claude Desktop无缝集成，分析客户反馈，生成见解，优先考虑功能，并创建可供执行的PRD——所有这些都使用自然语言。
关键价值主张
- 快70% 分散式挥发性有机化合物->人工智能发电
- 多源摄入：Slack、谷歌云端硬盘、Zoom、JIRA、CSV
- 智能优先级：6维VOC评分
- 有证据支持的决定：每个PRD都与客户报价相关联
- 50种专用工具：从收集到执行的完整工作流程
为什么开源？
产品管理正在随着人工智能的发展而发展，但大多数工具都是闭源的，而且价格昂贵。 该项目旨在使人工智能驱动的产品管理民主化 适合各种规模的团队。
通过开源此MCP服务器，我们正在创建一个平台，其中：
- 🤝 项目经理分享经验 -您的反馈分析见解有助于他人更好地确定优先级
- 🔧 工程师一起建造 -改进聚类算法，添加集成，增强AI提示
- 📚 社区增长知识 -记录最佳实践，共享PRD模板，教授新的PM
这不仅仅是一个工具，而是一场让产品管理更加数据驱动、基于证据、人人都能访问的运动。
如果你是一位曾与反馈过载作斗争的项目经理，或者是一位为项目经理构建工具的工程师， 这个项目是给你的贡献、学习并帮助塑造人工智能辅助产品管理的未来。
______________________________________________________________________
✨ 特性
📥 多源反馈收集
- Slack -自动同步通道与AI驱动的客户检测
- Google 云端硬盘 -使用OCR处理文档和PDF
- 变焦 -自动获取录音，AI转录分析
- JIRA -与问题跟踪双向同步
- CSV/手册 -批量上传或快速捕获
🧠 AI驱动的分析
- 语义聚类 -自动对类似反馈进行分组
- 洞察力生成 -AI创建可操作的主题
- 情绪检测 -识别紧急与美好
- 客户归因 -自动匹配客户反馈
🎯 智能优先级
- VOC评分 -6维评分（0-100）：
- 客户影响（30%）-层级、收入、战略 - 频率（20%）-提及频率 - 近期（15%）-近期 - 情绪（15%）-紧急程度 - 主题对齐（10%）-战略契合 - 工作量（10%）-实施复杂性
📄 PRD一代
- AI驱动的PRD -基于洞察的战略文件
- 循证 -包括直接客户报价
- 分段感知 -专为企业与中小企业量身定制
- 风险评估 -基于努力的实施风险
- 版本跟踪 -PRD历史和更新
🔄 JIRA集成
- 双向同步 -问题↔ 反馈
- 自动优先级 -VOC得分→ JIRA优先级
- 问题创建 -根据见解创作史诗
- 链接跟踪 -跟踪问题反馈
______________________________________________________________________
🚀 快速开始
先决条件
安装
pip install produckai-mcp-server配置
- 创建环境文件：
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY- 配置Claude桌面 (
~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"produckai": {
"command": "produckai-mcp",
"env": {
"ANTHROPIC_API_KEY": "your-api-key-here"
}
}
}
}- 重新启动克劳德桌面
首先使用
在Claude中尝试以下命令：
"Upload the demo feedback CSV at ./demo-data/feedback.csv"
"Run clustering and show me the top themes"
"Calculate VOC scores and show top 5 insights"
"Generate a PRD for the highest-priority insight"______________________________________________________________________
🛠️ 可用工具（共50个）
📥 摄入（21种工具）
- Slack：设置、同步频道、标记客户、机器人过滤器
- Google 云端硬盘：设置、浏览、同步文件夹、预览、处理配置
- 变焦：设置、同步录制、分析会议、见解、客户链接
- JIRA：设置、浏览项目、双向同步、映射、报告
- 手册：CSV上传、Zoom转录、原始捕获、模板
⚙️ 加工（4个工具）
run_clustering-生成主题和见解generate_embeddings-创建向量嵌入get_themes-列出所有主题get_theme_details-深入探讨主题
🔍 查询（4个工具）
search_insights-自然语言搜索get_insight_details-全面洞察数据search_feedback-搜索原始反馈get_customer_feedback-客户特定视图
🎯 VOC评分（4个工具）
calculate_voc_scores-分数反馈/主题get_top_feedback_by_voc-优先级排序列表configure_voc_weights-自定义算法get_voc_trends-跟踪随时间的变化
📄 PRD生成（6个工具）
generate_prd-从洞察力创建PRDlist_prds-浏览生成的PRDget_prd-查看完整PRDupdate_prd_status-工作流跟踪regenerate_prd-更改后更新export_prd-导出到降价
🏥 管理（11种工具）
- 状态检查、同步监控、健康检查、配置
📊 快速参考
| 集成 | 设置时间 | 成本/月 | 主要功能 |
|---|---|---|---|
| Slack | 10分钟 | 1-2美元 | 人工智能分类、增量同步、机器人过滤 |
| Google 云端硬盘 | 15分钟 | 5-10美元 | 多格式、评论、自动检测 |
| 变焦 | 10分钟 | 3-4美元 | 自动下载、人工智能分析、情绪 |
| JIRA | 5分钟 | 免费 | 双向，VOC优先，证据 |
| CSV文件 | 0分钟 | 免费 | 批量上传、模板、快速捕获 |
| 特性 | 时间 | 成本 | 产量 |
|---|---|---|---|
| 聚类 （100件） | 1-2分钟 | 0.20美元 | 主题和见解 |
| VOC评分 （100个项目） | 10秒 | $0.01 | 优先级排名（0-100） |
| PRD一代 | 10-15秒 | 0.05-0.10美元 | 战略文件 |
______________________________________________________________________
📖 完整工作流示例
每周反馈分类（20分钟）
# Monday: Collect feedback
"Sync Slack #customer-feedback channel for the last 7 days"
"Sync Zoom recordings from the past week"
"Upload the quarterly feedback CSV"
# Tuesday: Analyze
"Run clustering to identify themes"
"Show me the top 10 themes by feedback count"
# Wednesday: Prioritize
"Calculate VOC scores for all insights"
"Show me the top 5 highest-priority insights"
# Thursday: Document
"Generate a PRD for the top insight about API rate limiting"
"Export the PRD to ~/Documents/PRDs/"
# Friday: Execute
"Sync the top 3 insights to JIRA project PROD"
"Show JIRA sync status"结果： 3个高管就绪的PRD，同步到JIRA，有客户反馈支持的证据。
______________________________________________________________________
🏗️ 建筑
┌─────────────────┐
│ Data Sources │ Slack, Drive, Zoom, JIRA, CSV
└────────┬────────┘
│
▼
┌─────────────────┐
│ MCP Server │ 50 tools, state management, AI classification
│ (This Package) │
└────────┬────────┘
│
▼
┌─────────────────┐
│ ProduckAI API │ Clustering, insights, embeddings
│ (Optional) │
└────────┬────────┘
│
▼
┌─────────────────┐
│ Claude Desktop │ Natural language interface
└─────────────────┘部署模型： 本地单用户（每个PM运行自己的实例）
______________________________________________________________________
🧪 演示数据
使用示例数据尝试ProduckAI：
# Generate demo data (50 feedback items)
python scripts/generate_demo_data.py
# In Claude:
"Upload demo-data/feedback.csv"
"Run clustering"
"Generate PRD for top insight"看 演示数据/README.md 了解详情。
______________________________________________________________________
🔐 集成设置
Slack
- 创建Slack应用程序：https://api.slack.com/apps
- 添加作用域：
channels:history,channels:read,users:read - 安装到工作区
- 在克劳德：
"Setup Slack integration"
Google 云端硬盘
- 创建GCP项目：https://console.cloud.google.com
- 启用Google Drive API
- 创建OAuth凭据（桌面应用程序）
- 在克劳德：
"Setup Google Drive integration"
JIRA
- 生成API令牌：https://id.atlassian.com/manage/api-tokens
- 在克劳德：
"Setup JIRA integration with server URL, email, and token"
变焦
- 创建OAuth应用程序：https://marketplace.zoom.us/develop/create
- 添加范围：
recording:read:admin - 在克劳德：
"Setup Zoom integration"
看 docs/ 获取详细的设置指南。
______________________________________________________________________
📚 文档
______________________________________________________________________
🧑💻 发展
设置
# Clone repository
git clone https://github.com/produckai/produckai-mcp-server.git
cd produckai-mcp-server
# Create virtual environment
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# Install in development mode
pip install -e ".[dev]"测试
# Run tests
pytest
# Run with coverage
pytest --cov
# Run linting
ruff check .
# Format code
black .
# Type checking
mypy src/代码质量
我们使用：
- 黑色 用于代码格式化
- 拉夫 对于linting
- MyPy 的 用于类型检查
- Pytest 用于测试
看 贡献.md 作为指导方针。
______________________________________________________________________
🐛 故障排除
MCP服务器未出现在Claude中
- 检查配置：
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json - 验证命令：
which produckai-mcp - 检查日志：
tail -f ~/.produckai/logs/mcp-server.log - 完全重新启动克劳德桌面
API连接问题
# Test Anthropic API
export ANTHROPIC_API_KEY=your-key
python -c "from anthropic import Anthropic; print(Anthropic().messages.create(model='claude-3-haiku-20240307', max_tokens=10, messages=[{'role':'user','content':'hi'}]))"常见问题
- “找不到命令” -确保
produckai-mcp在PATH中 - “连接被拒绝” -检查是否设置了API密钥
- “导入错误” -重新安装：
pip install --force-reinstall produckai-mcp-server
看 docs/TROUBLESHOOTING.md 更多。
______________________________________________________________________
🤝 贡献
我们欢迎捐款！方法如下：
- 分叉 存储库
- 创建 特征分支：
git checkout -b feature/your-feature - 提交 您的更改：
git commit -m "Add feature" - 推 到你的叉子：
git push origin feature/your-feature - 打开 拉取请求
看 贡献.md 详细指南。
我们需要帮助的领域：
- 📖 文档改进
- 🐛 Bug修复和测试
- ✨ 新的集成源
- 🌍 国际化
- 🎨 UI/UX改进
______________________________________________________________________
📊 性能和成本
速度
- 反馈同步： 每个项目约1-2秒
- 集群： 100个项目约1-2分钟
- PRD生成： 每个PRD约10-15秒
成本（AI API）
- 嵌入： 每100件商品约0.01美元（OpenAI）
- 聚类/洞察： 每100件约0.20美元（克劳德·海库）
- PRD一代： 每个PRD约0.05-0.10美元（克劳德·十四行诗）
- 每月（100 PRD）： 总计约5-10美元
______________________________________________________________________
📄 许可证
MIT许可证-请参阅 许可证 了解详情。
______________________________________________________________________
🙏 致谢
- 内置于 MCP-SDK
- 由...驱动 安thropic克劳德
- 受到各地产品团队的启发
______________________________________________________________________
🔗 链接
______________________________________________________________________
⭐ 明星历史
如果你觉得这个项目有用，请加星！它帮助其他人发现ProduckAI。
______________________________________________________________________
📧 联系方式与社区
联系我们
- 造物主： 罗希特·萨拉夫(rohitsaraff33@gmail.com)
- 问题： -Bug报告、功能请求
- 讨论： -问题、想法、展示
愿景与社区
这个项目是为 产品经理目标是创建一个繁荣的开源社区，让建设者 增强集成，改进洞察力生成逻辑，分享学习成果，使整个PM社区受益。
我们特别欢迎在以下方面作出贡献：
- 🔌 集成增强 -新数据源（线性、概念、汇流等）
- 🧠 洞察力生成 -先进的聚类算法，情感分析改进
- 📊 分析和指标 -新的VOC评分维度、优先级框架
- 📝 PRD模板 -行业特定或公司特定的变化
- 🌍 本地化 -为全球团队提供多语言支持
无论您是改进工作流程的项目经理，还是为项目经理构建更好工具的工程师，您的贡献都能帮助产品中的每个人 社区。让我们一起建造这个！
______________________________________________________________________
内置于❤️ 通过 罗希特·萨拉夫 以及产品管理社区
______________________________________________________________________
由...制作❤️ ProduckAI社区