비공식 Fellow MCP 서버

면책 조항: 이 서버는 Fellow.ai API를 위한 비공식 커뮤니티 유지 관리 MCP 서버입니다. Fellow, Inc.와 제휴, 보증 또는 관련이 없습니다. "Fellow"는 Fellow, Inc.의 등록 상표입니다.

Fellow.ai API를 래핑하여 회의 데이터, 녹취록, 요약, 작업 항목 및 참가자에 액세스할 수 있는 도구를 제공하는 로컬 MCP(Model Context Protocol) 서버입니다.

기능:

• 회의 데이터 캐싱을 위한 로컬 SQLite 데이터베이스

• 작업 항목을 최신 상태로 유지하기 위한 자동 증분 동기화

• 캐시된 노트 전체 텍스트 검색

• 참가자별 회의 찾기

설치

npm install -g unofficial-fellow-mcp

설정

1. Fellow API 자격 증명 가져오기

1. Fellow 계정에 로그인합니다.

2. 사용자 설정의 개발자 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 개발자 API를 래핑합니다. API는 다음을 사용합니다:

• 인증을 위한 X-API-KEY 헤더

• 목록 작업을 위한 POST 요청 (필터/페이지네이션을 위한 JSON 본문 포함)

• 개별 리소스 검색을 위한 GET 요청