使用说明
MCP Fathom 服务器
一个用于Fathom AI会议的模型上下文协议(MCP)服务器,集成了API,支持HTTP/SSE传输和Bearer令牌认证。
特点
- HTTP/SSE 传输通过HTTPS使用服务器发送事件(Server-Sent Events)进行访问
- 承载令牌认证使用自定义承载令牌实现安全访问
- Fathom AI 集成列出并搜索来自您Fathom账户的会议
- Render.com 准备就绪优化为在Render.com上部署
环境变量
服务器需要以下环境变量:
FATHOM_API_KEY您的Fathom AI API密钥MCP_BEARER_TOKEN用于认证的自定义承载令牌PORT服务器端口(可选,默认为3000)
Render.com 部署
1. 创建一个新的网络服务
- 去你的(这里根据语境,可以理解为“去你的地方”或“去你自己的地方”,但直接翻译可能略显生硬,具体含义需结合上下文) 渲染仪表盘
- 点击“新建+”→“Web服务”
- 连接您的GitHub仓库
2. 配置构建设置
- 构建命令:
npm install && npm run build - 启动命令:
npm start - 环境:
Node
3. 设置环境变量
在您的渲染服务设置中,添加以下环境变量:
FATHOM_API_KEY=your_fathom_api_key_here
MCP_BEARER_TOKEN=your_secure_bearer_token_here
MCP_TIMEOUT=300000
4. 部署
点击“创建Web服务”并等待部署完成。
您的MCP服务器将在以下地址可用: https://your-app-name.onrender.com/sse
客户端配置
配置您的MCP客户端以连接到服务器:
{
"mcpServers": {
"fathom": {
"url": "https://your-app-name.onrender.com/sse",
"headers": {
"Authorization": "Bearer your_secure_bearer_token_here"
}
}
}
}
可用工具
搜索会议
全面搜索Fathom会议,支持高级过滤和丰富的数据检索功能。可按标题、摘要、行动项或参会者中的关键词进行搜索。自动排除执行团队和个人团队。
参数:
search_term(必填):在会议标题、摘要、行动项目或参会者姓名中搜索的关键词limit(可选):要返回的会议最大数量(默认:50,最大:100)days_back(可选):从今天起往前追溯的天数(默认:180天,最大:365天)created_after(可选):过滤在此日期之后创建的会议(ISO 8601 格式)。如果提供,则覆盖 days_back 设置。created_before(可选):筛选在此日期之前创建的会议(ISO 8601 格式)exclude_teams(可选):从结果中排除的团队(默认:['高管', '个人'])include_transcript(可选):是否包含完整转录文本(默认:否,警告:文件可能非常大且加载缓慢)include_summary(可选):是否包含会议摘要(默认:true)include_action_items(可选):是否包含行动项(默认:true)calendar_invitees(可选):按参会者电子邮件地址筛选calendar_invitees_domains(可选):按公司域名过滤recorded_by(可选):按会议所有者电子邮件地址筛选
特点:
- ✅ 全面搜索 跨标题、摘要、行动项、参会人员和会议记录
- ✅ 丰富的数据检索 默认包含摘要和行动项
- ✅(对号,表示正确、确认或完成) 智能团队筛选 自动排除执行会议和个人会议
- ✅ 灵活的日期筛选 在过去几天或特定日期范围内
- ✅ 高API限制 (最多100场会议)以提高搜索覆盖范围
API 端点
GET /sse- MCP 服务器发送事件端点(需要承载令牌)GET /health- 健康检查端点(无需认证)
安全
- 所有MCP终端点均需要承载令牌认证
- 在生产环境中使用一个强大且唯一的承载令牌
- 健康检查端点对所有人公开,用于监控目的
发展
本地开发
-
安装依赖项:
npm install -
设置环境变量:
export FATHOM_API_KEY=your_fathom_api_key export MCP_BEARER_TOKEN=your_bearer_token -
构建并运行:
npm run build npm start -
测试连接:
curl -H "Authorization: Bearer your_bearer_token" http://localhost:3000/health
使用MCP Inspector进行测试
npm run test
许可证
麻省理工学院(MIT)
