非官方 Fellow MCP 服务器

免责声明： 这是一个非官方的、由社区维护的 Fellow.ai API 的 MCP 服务器。它与 Fellow, Inc. 没有关联、认可或联系。“Fellow”是 Fellow, Inc. 的注册商标。

一个本地 MCP (Model Context Protocol) 服务器，封装了 Fellow.ai API，提供访问会议数据、会议记录、摘要、行动项和参与者的工具。

功能：

• 用于缓存会议数据的本地 SQLite 数据库

• 自动增量同步以保持行动项更新

• 缓存笔记的全文本搜索

• 按参与者查找会议

安装

npm install -g unofficial-fellow-mcp

设置

1. 获取您的 Fellow API 凭据

1. 登录您的 Fellow 账户

2. 导航到用户设置中的 Developer API 设置

3. 生成一个新的 API 密钥

4. 记录您的工作区子域名（URL 中 .fellow.app 之前的部分）

2. 配置您的 MCP 客户端

将以下内容添加到您的 MCP 客户端配置中（例如 ~/.config/opencode/opencode.json）：

{
  "mcp": {
    "fellow": {
      "type": "local",
      "command": ["npx", "-y", "unofficial-fellow-mcp"],
      "environment": {
        "FELLOW_API_KEY": "YOUR_FELLOW_API_KEY_HERE",
        "FELLOW_SUBDOMAIN": "YOUR_SUBDOMAIN"
      },
      "enabled": true
    }
  }
}

可用工具

API 工具（直接调用 Fellow API）

search_meetings

在 Fellow 中搜索会议/录音。

参数：

• title（可选）：按会议标题过滤（不区分大小写的模糊匹配）

• created_at_start（可选）：过滤在此日期之后创建的会议（ISO 格式）

• created_at_end（可选）：过滤在此日期之前创建的会议（ISO 格式）

• limit（可选）：结果的最大数量（1-50，默认为 20）

get_meeting_transcript

获取会议录音的完整文字记录，包含发言人标签和时间戳。

参数：

• recording_id（可选）：录音 ID

• meeting_title（可选）：按会议标题搜索

get_meeting_summary

获取会议摘要/笔记内容，包括议程项目、讨论主题和决定。

参数：

• note_id（可选）：笔记 ID

• recording_id（可选）：获取录音关联笔记的摘要

• meeting_title（可选）：按会议标题搜索

get_action_items

从单个会议的笔记中提取行动项。

参数：

• note_id（可选）：笔记 ID

• meeting_title（可选）：按会议标题搜索

get_meeting_participants

获取会议的参与者/出席者列表。

参数：

• note_id（可选）：笔记 ID

• meeting_title（可选）：按会议标题搜索

数据库工具（本地 SQLite 缓存）

sync_meetings

将会议从 Fellow API 同步到本地数据库。

参数：

• force（可选，默认：false）：如果为 true，则执行完全重新同步。否则执行增量同步（仅同步自上次同步以来新增/更新的内容）

• include_transcripts（可选，默认：false）：如果为 true，则同时获取并存储文字记录（速度较慢）

get_all_action_items

从本地数据库获取所有行动项。会自动先执行增量同步以确保数据是最新的。

参数：

• assignee（可选）：按负责人姓名过滤（模糊匹配）

• show_completed（可选，默认：false）：如果为 true，则包含已完成的行动项

• since（可选）：仅返回在此日期当天或之后会议中的行动项（ISO 格式：YYYY-MM-DD）

get_meetings_by_participants

查找包含特定参与者的会议。

参数：

• emails（必填）：要搜索的电子邮件地址列表

• require_all（可选，默认：false）：如果为 true，则仅返回所有指定参与者都出席的会议

search_cached_notes

对所有缓存的会议笔记（标题和内容）进行全文本搜索。

参数：

• query（必填）：搜索查询

get_sync_status

获取当前的同步状态和数据库统计信息。

本地数据库

会议数据缓存在 ~/.unofficial-fellow-mcp/fellow.db 的本地 SQLite 数据库中。这实现了：

• 快速本地搜索

• 跨所有行动项查询

• 按参与者查找会议

• 缓存数据的离线访问

数据库存储：

• 笔记（会议摘要、议程、内容）

• 录音（带有可选的文字记录）

• 行动项（从笔记中解析，包含负责人/截止日期提取）

• 参与者（电子邮件地址）

环境变量

开发

# Clone the repository
git clone <repo-url>
cd unofficial-fellow-mcp

# Install dependencies
npm install

# Create .env file with your credentials
echo "FELLOW_API_KEY=your_api_key_here" > .env
echo "FELLOW_SUBDOMAIN=your_subdomain" >> .env

# Watch mode for development
npm run dev

# Build
npm run build

# Test API connection
node --env-file=.env test-api.js

# Test MCP server
FELLOW_API_KEY=your_key FELLOW_SUBDOMAIN=your_subdomain node test-mcp.js

要求

• Node.js >= 18.0.0

• 具有 API 访问权限的 Fellow.ai 账户

许可证

MIT

API 参考

此 MCP 服务器封装了 Fellow Developer API。该 API 使用：

• X-API-KEY 请求头进行身份验证

• POST 请求用于列表操作（使用 JSON 正文进行过滤/分页）

• GET 请求用于检索单个资源