Fastmail MCP 서버 (비공식)

Fastmail 통합을 위한 비공식 Model Context Protocol 서버입니다. 검증된 JMAP 프록시 역할을 하는 단일 execute 도구를 제공합니다. LLM이 원시 JMAP 메서드 호출을 작성하면 서버가 검증, 인증 및 응답 정리를 처리합니다.

설정 지침

1. Fastmail API 토큰 받기

1. Fastmail에 로그인합니다.

2. Settings → Privacy & Security → API tokens로 이동합니다.

3. New API token을 클릭합니다.

4. 이름을 지정합니다 (예: "Claude MCP").

5. 필요한 범위를 선택합니다: Mail (필요에 따라 읽기/쓰기).

6. 생성된 토큰을 복사합니다.

2. Claude Code 구성

Claude Code MCP 설정(~/.claude/claude_desktop_config.json 또는 프로젝트 .mcp.json)에 다음을 추가합니다:

{
  "mcpServers": {
    "fastmail": {
      "type": "url",
      "url": "https://fastmail-mcp.i11v.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FASTMAIL_API_TOKEN"
      }
    }
  }
}

보안 참고: API 토큰을 안전하게 보관하세요. 버전 제어 시스템에 절대 커밋하지 마세요. 환경 변수나 보안 관리자 사용을 고려하세요.

사용 가능한 도구

execute

Fastmail에 대해 JMAP 메서드 호출을 실행합니다. JMAP 메서드 호출 트리플 배열 [methodName, args, callId]을 허용합니다.

입력:

{
  "methodCalls": [
    ["Email/query", {
      "filter": { "inMailbox": "INBOX_ID" },
      "sort": [{ "property": "receivedAt", "isAscending": false }],
      "limit": 10
    }, "call-0"],
    ["Email/get", {
      "ids": { "resultOf": "call-0", "name": "Email/query", "path": "/ids" },
      "properties": ["from", "subject", "receivedAt", "preview"]
    }, "call-1"]
  ]
}

서버 수행 작업:

• 구조, 메서드 이름 및 위생 규칙 검증

• accountId 자동 삽입

• Fastmail의 JMAP API로 전송

• 프로토콜 노이즈 제거 (state, queryState, canCalculateChanges 등)

• 정리된 methodResponses 반환

허용된 JMAP 메서드:

• Core/echo

• Mailbox/get, Mailbox/query, Mailbox/queryChanges, Mailbox/set

• Email/get, Email/query, Email/queryChanges, Email/set

• Thread/get

• SearchSnippet/get

• Identity/get

• EmailSubmission/get, EmailSubmission/query, EmailSubmission/set

검증 규칙:

• 모든 /get 호출(Mailbox/get, Identity/get 제외)에는 properties 배열이 포함되어야 합니다.

• 모든 /query 호출에는 limit이 포함되어야 합니다.

• /get 호출 시 ids: null은 거부됩니다(먼저 /query를 사용하세요).

• 파괴적 작업(destroy, EmailSubmission/set)은 사용자 확인을 요청하는 오류를 반환합니다.

compose_email (MCP 앱)

대화형 이메일 작성 양식을 엽니다. 선택적으로 필드(받는 사람, 참조, 숨은 참조, 제목, 본문)를 미리 채울 수 있습니다. MCP 앱을 지원하는 호스트에서는 전송 및 임시 보관 버튼이 포함된 인라인 작성 UI를 렌더링합니다. 다른 호스트에서는 구조화된 텍스트로 대체됩니다.

입력:

{
  "to": "recipient@example.com",
  "subject": "Hello",
  "body": "Message text..."
}

read_email (MCP 앱)

이메일의 전체 내용을 풍부한 읽기 뷰로 표시합니다. JMAP ID로 이메일을 가져와 헤더, 정리된 본문 및 작업 버튼(답장, 전체 답장, 전달)을 렌더링합니다. MCP 앱 지원이 없는 호스트에서는 구조화된 텍스트로 대체됩니다.

입력:

{
  "emailId": "M1234abcd"
}

사용 가능한 리소스

리소스 인식 MCP 클라이언트는 Fastmail 기술을 자동으로 수신합니다. 이는 LLM에게 execute JMAP 도구를 구동하는 방법을 가르치는 마크다운 파일 세트입니다. 리소스 우선순위를 지원하는 클라이언트는 SKILL.md를 먼저 로드하고 링크를 지연 로드합니다.

모든 리소스는 file:///fastmail-skill/<path> URI 스키마와 text/markdown MIME 유형을 사용합니다. 태그: audience: ["assistant"].

API 엔드포인트

• POST /mcp - MCP 프로토콜 엔드포인트

• GET /health - 상태 확인 엔드포인트

환경 변수

.env.example을 .env.development.local로 복사하고 값을 채우세요:

cp .env.example .env.development.local

개발

pnpm install   # Install dependencies
pnpm dev       # Run local dev server (wrangler)
pnpm check     # Run all checks (typecheck + lint + fmt + test)
pnpm run deploy:prod  # Deploy to Cloudflare

이 프로젝트는 비공식 커뮤니티 프로젝트이며 Fastmail과 관련이 없습니다.

소스 코드 및 이슈: GitHub