mcp-server

MCP（Model Context Protocol）服务器，将 MinuteMail 公开 API 暴露为工具。它让 AI 代理和 MCP 客户端能够通过 mm-api-gateway 操作 MinuteMail 邮箱、邮件、附件、域名、团队和模拟 OAuth 身份。

• 端点： https://mcp.minutemail.co/mcp（Streamable HTTP，协议修订版 2025-06-18）

• 认证： MCP 客户端的 Authorization: Bearer mmak_... 请求头会原样转发给 api-gateway——此服务器不持有任何凭据。作用域和配额由 api-gateway 强制实施，与任何 API 客户端完全相同。

• 无状态： 无会话，无服务端推送 SSE（GET /mcp 和 DELETE /mcp 返回 405）。健康检查：GET /health。

工具集（39 个工具）

每个工具与 api-gateway 的 /v1 路由一一对应。所有调用都需要 Bearer API 密钥；写操作需要匹配的作用域（mailboxes、domains、team、identities）。

邮箱（mailboxes 作用域）

归档邮箱（mailboxes 作用域）

mm_list_archived_mailboxes、mm_get_archived_mailbox、mm_delete_archived_mailbox、mm_reactivate_archived_mailbox。

域名（domains 作用域）

mm_list_domains、mm_register_domain、mm_verify_domain、mm_delete_domain。

团队（team 作用域）

mm_list_members、mm_add_member、mm_get_member、mm_delete_member、mm_create_invitation、mm_list_invitations、mm_delete_invitation。

模拟身份（identities 作用域）

mm_list_identities、mm_create_identity、mm_get_identity、mm_delete_identity、mm_list_oauth_clients、mm_create_oauth_client、mm_get_oauth_client、mm_delete_oauth_client、mm_rotate_client_secret。

未暴露

• /v1/api-keys 增删改查——API 密钥管理不通过 MCP 暴露；请从 Web 应用管理密钥。

• /internal/*——仅限内部使用。/metrics 提供 Prometheus 指标（运行时 go_*/process_* 计数器）供抓取；参见 METRICS.md。

Related MCP server: SandMail — Disposable Email API for AI Agents

示例

curl -s https://mcp.minutemail.co/mcp \
  -H 'Authorization: Bearer mmak_XXXXXXXX' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"mm_create_mailbox","arguments":{"expiresIn":30}}}'

工具结果以 MCP 文本内容返回，其中携带网关的 JSON 响应。非 2xx 的网关响应会变成 isError: true 的结果，并附带 HTTP 状态码和响应体（401 无效密钥、403 作用域/域权限、429 配额不足并附剩余计数、502 上游不可用）。

配置

开发

Go 1.23。使用标准库加 prometheus/client_golang 提供 /metrics。遵循 MinuteMail 服务标准（参见 mm-mailbox-service）。

go test ./...     # unit tests
go vet ./...
go run .          # local server on :8080