会议记录搜索服务

Fathom MCP Server是一个连接Claude和Fathom AI会议记录的服务,提供会议搜索、摘要、行动项提取等功能,支持关键词和语义搜索。

  • by aaronb458
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 aaronb458/Fathom_MCP

使用说明

Fathom MCP服务器

将克劳德连接到您的 父亲AI 会议记录。问克劳德一些事情,比如“我们上周决定了什么定价?”或者“给我看看我所有的行动项目”,它就会搜索你真正的Fathom数据——使用可选的人工智能语义搜索。

它能做什么?

  • 按主题搜索会议 --“我们讨论了第四季度预算的什么?”即使没有使用这些确切的单词(通过语义搜索),也能找到相关的会议
  • 每周摘要 --所有会议的压缩概述,而不是原始数据转储
  • 动作项提取 --跨会议拉取所有待办事项,按分配给谁进行筛选
  • 深入了解任何会议 --完整摘要、行动项目和按需记录
  • 浏览和筛选 --按日期、团队、录制者或受邀者域
  • 团队和成员 --看看谁在你的Fathom工作区
  • 网络钩子 --在处理新会议时收到通知

两种搜索模式

模式 需要 工作原理
关键字搜索 只需您的Fathom API键 搜索会议标题、摘要和行动项目以查找完全匹配的关键字
语义搜索 Fathom+OpenAI API密钥 使用AI嵌入来查找概念相关的内容-“预算问题”找到关于“成本结构”或“费率卡”的会议

语义搜索是可选的。没有它,一切都能正常工作——它只是让搜索更智能。


选择您的设置

选项 最适合 您需要什么
A.使用托管服务器 非技术用户,快速入门 只需您的API密钥
B.在本地运行 开发人员,完全控制 已安装Node.js+Git

选项A:使用托管服务器(最简单)

如果有人与您共享了托管URL(如 https://fathom-mcp.up.railway.app/mcp),你不需要安装任何东西。您所需要的只是您的Fathom API密钥。

步骤1:获取API密钥

  1. Fathom API密钥(必需):

    • 登录 英寻.视频
    • 首选 设置 > 集成 > API
    • 点击 生成API密钥 并复制它
  2. OpenAI API密钥(可选-启用语义搜索):

第二步:添加到Claude

Claude Desktop (the app)

打开您的Claude Desktop配置文件:

在Mac上:

  1. 打开查找器
  2. 点击 去 在菜单栏中,然后 转到文件夹。..
  3. 粘贴此内容并按Enter键: ~/Library/Application Support/Claude/
  4. 寻找 claude_desktop_config.json --用TextEdit打开它,或用该名称创建一个新文件

在Windows上:

  1. 按 Windows key + R,类型 %APPDATA%\Claude 然后按Enter键
  2. 寻找 claude_desktop_config.json --用记事本打开它,或用该名称创建一个新文件

将此内容粘贴到文件中:

{
  "mcpServers": {
    "fathom": {
      "type": "streamable-http",
      "url": "PASTE_SERVER_URL_HERE/mcp",
      "headers": {
        "x-fathom-api-key": "PASTE_YOUR_FATHOM_KEY_HERE",
        "x-openai-api-key": "PASTE_YOUR_OPENAI_KEY_HERE"
      }
    }
  }
}

替换三个 PASTE_... 如果你没有OpenAI密钥,只需完全删除那一行——一切仍然正常。

保存文件。

Claude Code (the terminal/CLI tool)

打开 ~/.claude.json 在任何文本编辑器中添加:

{
  "mcpServers": {
    "fathom": {
      "type": "streamable-http",
      "url": "PASTE_SERVER_URL_HERE/mcp",
      "headers": {
        "x-fathom-api-key": "PASTE_YOUR_FATHOM_KEY_HERE",
        "x-openai-api-key": "PASTE_YOUR_OPENAI_KEY_HERE"
      }
    }
  }
}

移除 x-openai-api-key 行,如果你没有一个。保存文件。

第三步:重启克劳德

  • 克劳德桌面: 完全退出应用程序(而不仅仅是关闭窗口)并重新打开它
  • 克劳德代码: 关闭终端,打开一个新终端,重新启动Claude Code

够了,你完了。


选项B:在本地运行

这将在您自己的计算机上安装服务器。克劳德会在需要时自动启动它。

先决条件(如果您已经拥有Node.js和Git,请跳过)

How to check if you already have them

打开终端:

  • 雨衣: 打开 终端 应用程序(在Spotlight中搜索“终端”)
  • 窗户: 打开 命令提示符 (在“开始”菜单中搜索“cmd”)

键入以下各项,然后按Enter键:

node --version
git --version

如果两者都显示版本号(如 v20.11.0),跳到步骤1。

Install Node.js
  1. 首选 https://nodejs.org
  2. 点击大绿色 长期支持 下载按钮
  3. 打开下载的文件并按照安装程序进行操作
  4. 关闭并重新打开终端,然后键入 node --version 确认
Install Git
  • 雨衣: 类型 git --version 在终端。如果未安装,您的Mac将提示您--单击 安装.
  • 窗户: 首选 https://git-scm.com,下载并安装默认值。

步骤1:获取API密钥

与上述步骤1的选项A相同——获取Fathom密钥(必需)和可选的OpenAI密钥。

第二步:下载并构建

运行这些 一次一个 在您的终端中:

git clone https://github.com/aaronb458/Fathom_MCP.git
cd Fathom_MCP
npm install
npm run build

然后获取此文件夹的完整路径:

  • Mac/Linux: pwd
  • 窗户: cd

复制结果(例如。, /Users/yourname/Fathom_MCP).

第三步:告诉克劳德这台服务器

Claude Desktop (the app)

打开配置文件(有关如何查找它,请参阅选项A,步骤2)并粘贴:

{
  "mcpServers": {
    "fathom": {
      "command": "node",
      "args": ["PASTE_YOUR_PATH_HERE/dist/index.js"],
      "env": {
        "FATHOM_API_KEY": "PASTE_YOUR_FATHOM_KEY_HERE",
        "OPENAI_API_KEY": "PASTE_YOUR_OPENAI_KEY_HERE"
      }
    }
  }
}

更换 PASTE_... 价值观。移除 OPENAI_API_KEY 行,如果你没有一个。保存。

Claude Code (the terminal/CLI tool)

打开 ~/.claude.json 并添加:

{
  "mcpServers": {
    "fathom": {
      "command": "node",
      "args": ["PASTE_YOUR_PATH_HERE/dist/index.js"],
      "env": {
        "FATHOM_API_KEY": "PASTE_YOUR_FATHOM_KEY_HERE",
        "OPENAI_API_KEY": "PASTE_YOUR_OPENAI_KEY_HERE"
      }
    }
  }
}

移除 OPENAI_API_KEY 行,如果你没有一个。保存。

第四步:重启克劳德

  • 克劳德桌面: 完全退出并重新打开
  • 克劳德代码: 关闭终端,打开新终端,启动Claude Code

完成。


试试看

一旦设置好,只需自然地与克劳德交谈:

  • “我本周的会议发生了什么?”
  • “在上周的会议上,我们对定价做出了什么决定?”
  • “显示过去7天的所有操作项”
  • “获取我上次客户电话的完整记录”
  • “分配给Sarah的行动项目是什么?”
  • “总结昨天的脱口秀”

工具参考

工具 它做什么
fathom_search_meetings 按主题/关键字在摘要(语义或关键字)中搜索
fathom_meeting_digest 按日期范围压缩的会议概述
fathom_get_meeting_detail 一次特定会议的完整摘要+记录
fathom_action_items 跨会议的行动项目,可由受让人选择
fathom_list_meetings 按日期、团队、记录者浏览/筛选会议
fathom_list_teams 列出工作区团队
fathom_list_team_members 列出团队成员
fathom_create_webhook 创建会议事件webhook
fathom_delete_webhook 删除webhook

托管自己的服务器

部署它,这样朋友/队友就可以在不安装任何东西的情况下使用它。

铁路(推荐)

  1. 在GitHub上分叉此仓库
  2. 首选 railway应用程序,创建新项目
  3. 选择 从GitHub仓库部署 然后选择你的叉子
  4. Railway自动检测Dockerfile并进行部署

与朋友分享网址——他们关注 选项A 每个人都有自己的API密钥。服务器从不存储密钥。

码头工人

npm run build
docker build -t fathom-mcp .
docker run -p 3000:3000 fathom-mcp

什么不起作用?

“FATHOM_API_KEY环境变量是必需的”

打开配置文件,检查API密钥是否在正确的位置。

“Fathom API错误:401未经授权”

API密钥错误或已过期。在Fathom设置中生成一个新的。

“缺少Fathom API密钥” (远程模式)

您的配置需要 x-fathom-api-key 头球

工具未显示

  1. 当地人:你跑了吗 npm run build这条路是否以…结束 /dist/index.js?
  2. Remote:是以结尾的URL /mcp?
  3. 你重启克劳德了吗?

搜索结果不好

为语义搜索添加一个OpenAI API键。没有它,只有精确的关键字匹配才能工作。


对于开发者

# Local stdio mode
FATHOM_API_KEY=your-key npm run dev

# Local with semantic search
FATHOM_API_KEY=your-key OPENAI_API_KEY=your-key npm run dev

# Remote HTTP mode
npm run dev:remote

# Build for production
npm run build

许可证

麻省理工学院