会议数据处理工具

一个通过FastMCP v2构建的MCP服务器,用于处理和备份Granola.ai的会议数据,包括搜索、转录、笔记和模式分析等功能。

  • by jeffmm
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jeffmm/granola-fast-mcp

使用说明

燕麦快餐

一个MCP服务器,暴露您的 格拉诺拉.ai 会议数据——搜索、记录、笔记和模式分析——作为工具。内置于 FastMCP v2。

它直接从磁盘上的Granola本地缓存文件读取。没有API密钥,没有外部调用。包括一个非破坏性的备份系统,可以保留Granola可能从其本地缓存中删除的会议数据(尤其是成绩单)。

注: 默认缓存路径假定为macOS(~/Library/Application Support/Granola/cache-v3.json).如果您在另一个平台上运行Granola,请设置 GRANOLA_CACHE_PATH 将环境变量移动到正确的位置。

工具

工具 说明
search_meetings 按标题、参与者或成绩单内容搜索
get_meeting 会议详细信息(标题、日期、类型、参与者)
get_transcript 带有演讲者标签的完整成绩单
get_notes 人工智能生成的会议笔记和摘要
analyze_patterns 交叉会议分析:主题、参与者、频率
backup_cache 将会议数据无损备份到 ~/.granola-backup/

设置

需要Python 3.13+和 紫外线.

uv sync

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "granola": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/granola-fast-mcp", "granola-fast-mcp"]
    }
  }
}

克劳德代码

claude mcp add granola -- uv run --directory /path/to/granola-fast-mcp granola-fast-mcp

运作原理

Granola的桌面应用程序将会议数据写入 ~/Library/Application Support/Granola/cache-v3.json此服务器将该文件解析为结构化的会议、成绩单和文档数据,这些数据作为MCP工具公开。

自动备份

启动时(以及实时缓存更改时),服务器将Granola缓存合并到本地备份中 ~/.granola-backup/backup.json,然后从备份中提供数据。这很重要,因为Granola的本地缓存会在几天后删除转录本——备份会无限期地保留它们。

合并是非破坏性的:从实时缓存中消失的会议保留在备份中,空值永远不会覆盖真实数据。每次合并之前,备份的带时间戳的快照都会作为安全网保存。

您还可以手动运行备份:

uv run granola-backup

提示: Granola仅在您在应用程序中打开会议时将成绩单加载到本地缓存中。要回填旧会议的记录,请在Granola中单击它们,然后在它们被驱逐之前运行备份以捕获它们。

配置

设置通过环境变量(前缀为 GRANOLA_):

变量 默认值 描述
GRANOLA_CACHE_PATH ~/Library/Application Support/Granola/cache-v3.json Granola缓存文件的路径
GRANOLA_BACKUP_DIR ~/.granola-backup 备份文件和快照目录
GRANOLA_MAX_SNAPSHOTS 10 要保留的最大时间戳快照数
GRANOLA_LOG_LEVEL info 日志记录级别

发展

uv run pytest              # run tests
uv run ruff format src/ tests/   # format
uv run ruff check src/ tests/    # lint
uv run prek                # run all pre-commit hooks