使用说明
Granola MCP服务器
一 街机 暴露的MCP服务器 格兰诺拉麦片 会议智能——笔记、成绩单、与会者和日历元数据——作为任何MCP兼容客户端(Claude Code、Cursor等)的工具。
建立在 arcade-mcp-server 通过Arcade Cloud进行OAuth 2.1资源服务器身份验证。
工具
| 工具 | 说明 |
|---|---|
list_meetings |
列出具有可选日期范围筛选器和光标分页的会议。仅返回元数据(无注释/成绩单)。 |
get_meeting |
获取单个会议的完整元数据——与会者、日历事件、文件夹、持续时间估计。 |
get_meeting_transcript |
获取带有说话者标签、时间戳和可选说话者过滤的逐字记录 |
所有工具都需要 GRANOLA_API_KEY (企业API密钥),作为服务器端机密注入-它永远不会暴露给LLM或MCP客户端。
先决条件
- Python 3.10+
- 紫外线 包管理器
- A. 格兰诺拉企业API密钥
快速开始
# 1. Install dependencies
make install
# 2. Configure your API key
cp .env.example .env
# Edit .env and add your Granola API key
# 3. Start the server (HTTP on port 8000)
make dev
服务器现在正在运行 http://localhost:8000/mcp。将您的MCP客户端指向此确切的URL,并开始查询您的会议。
认证
此服务器使用 OAuth 2.1资源服务器 身份验证。使用Ed25519签名的JWT令牌对Arcade Cloud的授权服务器验证传入请求。服务器:
- 通过JWKS验证令牌签名
https://cloud.arcade.dev/.well-known/jwks/oauth2 - 验证发卡机构是否
https://cloud.arcade.dev/oauth2 - 检查受众是否与服务器的规范URL匹配
- 地图
email对Arcade工具授权的用户身份进行声明
配置
| 环境变量 | 描述 |
|---|---|
GRANOLA_API_KEY |
Granola Enterprise API密钥(必需) |
发展
make install # Install all dependencies (including dev extras)
make test # Run tests with coverage
make lint # Run linting and type checking
make build # Build wheel
项目结构
arcade_granola/
├── __main__.py # Server entrypoint, resource server auth config
├── auth.py # API key auth provider
├── client.py # Async HTTP client for Granola's public API
├── models.py # Pydantic models for API responses
└── tools/
├── _common.py # Shared helpers (client factory, URL builders)
└── meetings.py # Meeting tools (list, get, transcript)
