格兰诺拉-克劳德-mcp

Name: 格兰诺拉-克劳德-mcp
Author: cobblehillmachine

作者：cobblehillmachine15 星标更新：2025-07-31

安装使用来源：spider==github.com

项目介绍

Granola-Claude MCP 服务器

将您的会议数据转化为AI驱动的商业智能

这是一个自定义的模型上下文协议（MCP）服务器，它将Granola.ai的会议数据直接连接到Claude Desktop，使您能够跨整个会议历史进行自然语言查询。

🚀 为什么存在这个项目

尽管Granola-MCP在互联网上被广泛记录，包括详细的特性列表和安装指南，但实际的仓库和PyPI包并不存在。为了避免等待官方发布，我们逆向工程了Granola的本地缓存结构，并从头开始构建了一个全面的MCP服务器。

结果如何？ 您可以向Claude提问如下问题：

"展示上个月讨论预算的所有客户会议"
"哪些团队成员需要跟进Enron项目的会议？"
"分析我们与外部客户相比内部团队会议的模式"

✨ 特性

🔍 自然语言会议智能

使用纯英语查询273+次会议
在标题、内容和参与者名单中搜索
即时访问会议元数据和日历集成

📊 高级分析

会议统计和模式识别
参会者分析和参与度跟踪
从会议历史重建项目时间线

🔗 完全集成

Google日历事件详情和参会者响应
会议链接（Google Meet, Zoom）和参与状态
包括组织者、响应状态和共享设置在内的丰富元数据

🛡️ 隐私优先架构

所有数据处理都在本地进行 - 不上传到云端
直接访问缓存文件 - 没有API依赖
尊重现有的Granola权限和访问控制

🎯 使用场景

项目管理

"显示关于XXI Media项目的会议并确定下一步行动"
→ 显示7月16日与Pyxl的Zoom会议，参会者状态及行动项

客户关系

"本周哪些客户有'需要行动'的响应？"
→ 跨所有客户接触点识别跟进需求

团队分析

"谁参加了最多的外部客户会议？"
→ 分析工作负载分布和发展机会

会议投资回报率

"比较Google Meet与Zoom会议的结果"
→ 未来规划的平台有效性分析

🛠️ 安装

预备条件

macOS 已安装并配置了Granola.ai
Python 3.12+
Claude Desktop 应用程序
活跃的Granola会议历史

快速开始

克隆仓库

git clone https://github.com/[USERNAME]/granola-claude-mcp.git
cd granola-claude-m

使服务器可执行
```
chmod +x granola_mcp_server.py
```

测试安装

python3 test_granola.py

您应该看到：

✅ 缓存加载成功！
📊 统计数据：[您的会议数据]
📅 最近的会议：[您的最近会议]

配置Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "granola-mcp": {
      "command": "python3",
      "args": ["/path/to/granola-claude-mcp/granola_mcp_server.py"],
      "env": {
        "GRANOLA_CACHE_PATH": "/Users/[username]/Library/Application Support/Granola/cache-v3.json"
      }
    }
  }
}

重启Claude Desktop

完全退出（⌘+Q），然后重新启动Claude Desktop。
测试集成

向Claude提问："展示我最近的Granola会议"

🔧 可用工具

`get_recent_meetings`

获取最近的会议及其完整元数据

参数：limit（整数，最大值50）
返回：带有标题、日期、参会者、日历集成的会议列表

`search_meetings`

在会议标题和内容中搜索

参数：query（字符串），limit（整数，最大值20）
返回：匹配的会议及其相关性评分

`get_meeting_details`

深入特定会议的数据

参数：meeting_id（字符串）
返回：完整的会议信息，包括笔记、参会者、会议详情

`get_statistics`

跨会议语料库的分析

参数：无
返回：会议数量、转录可用性、词数、趋势

🏗️ 架构

数据流

Granola.ai → 本地缓存 → MCP服务器 → Claude Desktop → AI智能

缓存结构

Granola使用复杂的“双JSON”编码：

# 标准JSON文件包含JSON字符串
cache_data = json.loads(data['cache'])
state = cache_data['state']

# 三个主要数据集合：
documents = state['documents']        # 273+会议记录
metadata = state['meetingsMetadata']  # 28个关系对象  
transcripts = state['transcripts']    # 16个可用转录

MCP协议实现

符合MCP 2025-06-18协议
正确初始化和能力协商
错误处理和优雅降级
实时查询处理，响应时间小于一秒

🐛 故障排除

“服务器失败”在Claude Desktop中

查看日志：Claude Desktop → 设置 → 开发者 → 打开日志文件夹
验证配置中的文件路径
手动测试服务器：python3 granola_mcp_server.py

“未找到会议”

确保Granola.ai已处理会议
验证缓存文件是否存在：ls -la ~/Library/Application\ Support/Granola/
检查缓存文件大小（活跃用户应为几MB）

Python/权限问题

验证Python 3.12+：python3 --version
使服务器可执行：chmod +x granola_mcp_server.py
检查Granola缓存目录的文件权限

MCP连接问题

完全重启Claude Desktop（⌘+Q，然后重新打开）
验证claude_desktop_config.json中的JSON语法
检查环境变量路径是否匹配您的用户名

🤝 贡献

我们欢迎贡献！此项目填补了AI生产力生态系统中的一个真实空白。

贡献方式：

🐛 错误报告：特定会议格式或边缘情况的问题
✨ 功能请求：额外的分析、导出格式、集成想法
🔧 代码贡献：性能改进、额外的MCP工具
📚 文档：设置指南、使用案例示例、故障排除

开发设置

git clone https://github.com/[USERNAME]/granola-claude-mcp.git
cd granola-claude-mcp

# 测试更改
python3 test_granola.py

# 为调试手动运行服务器
python3 granola_mcp_server.py

📋 发展路线图

第二阶段：高级分析

提取行动项的转录分析
会议效果的情感分析
自动化跟进推荐引擎
跨会议主题和决策追踪

第三阶段：增强集成

实时缓存监控以实现即时更新
多平台会议数据（超越Google日历）
导出功能（PDF报告、CSV分析）
会议智能的仪表板网页界面

第四阶段：企业功能

带有访问控制的多用户部署
CRM集成以实现完整的客户生命周期跟踪
高级报告和商业智能
第三方集成的API开发

📄 许可证

MIT许可证 - 详情见LICENSE文件。

🙏 致谢

Anthropic 为模型上下文协议规范
Granola.ai 为构建复杂的会议智能（即使MCP集成缺失）
MCP社区 为示例和最佳实践

📞 支持

问题：GitHub问题
讨论：GitHub讨论
专业服务：对于定制集成和企业部署，请联系Cobble Hill

⭐ 如果这个项目帮助您从会议中提取更多价值，请给它点赞！

由Cobble Hill团队打造 - AI集成专家