Неофициальный сервер Fellow MCP

Отказ от ответственности: Это неофициальный, поддерживаемый сообществом сервер MCP для API Fellow.ai. Он не связан с Fellow, Inc., не поддерживается и не ассоциируется с ней. "Fellow" является зарегистрированной торговой маркой Fellow, Inc.

Локальный сервер MCP (Model Context Protocol), который оборачивает API Fellow.ai, предоставляя инструменты для доступа к данным встреч, расшифровкам, резюме, пунктам действий и участникам.

Возможности:

• Локальная база данных SQLite для кэширования данных встреч

• Автоматическая инкрементальная синхронизация для поддержания актуальности пунктов действий

• Полнотекстовый поиск по кэшированным заметкам

• Поиск встреч по участникам

Установка

npm install -g unofficial-fellow-mcp

Настройка

1. Получите учетные данные API Fellow

1. Войдите в свою учетную запись Fellow

2. Перейдите в настройки API разработчика в настройках пользователя

3. Создайте новый ключ API

4. Запишите поддомен вашего рабочего пространства (часть перед .fellow.app в вашем URL)

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 (прямые вызовы API Fellow)

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

Синхронизация встреч из API Fellow в локальную базу данных.

Параметры:

• 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

Получение текущего статуса синхронизации и статистики базы данных.

Локальная база данных

Данные встреч кэшируются в локальной базе данных SQLite по адресу ~/.unofficial-fellow-mcp/fellow.db. Это обеспечивает:

• Быстрый локальный поиск

• Запросы по всем пунктам действий

• Поиск встреч по участникам

• Автономный доступ к кэшированным данным

База данных хранит:

• Заметки (резюме встреч, повестки дня, содержимое)

• Записи (с дополнительными расшифровками)

• Пункты действий (извлеченные из заметок с указанием исполнителя/срока выполнения)

• Участников (адреса электронной почты)

Переменные окружения

Разработка

# 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

• Учетная запись Fellow.ai с доступом к API

Лицензия

MIT

Справочник API

Этот сервер MCP оборачивает Fellow Developer API. API использует:

• Заголовок X-API-KEY для аутентификации

• POST-запросы для операций со списками (с телом JSON для фильтров/пагинации)

• GET-запросы для получения отдельных ресурсов