Personal Suite

StudioMeyer MCP Stack 的一部分 — 在马略卡岛打造 🌴 · 如果你在用，给个 ⭐

---

我们想说几句

过去两年里，我们一直在为自己构建工具和系统。这个仓库规模小、星标少，并不是因为它刚刚创建，而是因为我们直到现在才决定分享我们打造的东西。这不是一次全新的尝试，而是一段漫长历程，只是最近才有提交记录。

我们喜欢构建和分享，不喜欢社交媒体套路、增长黑客手段，也不热衷于追逐星标和关注者。所以这个仓库规模不大。代码是真实的，我们自己也在使用，问题也会得到回复。欢迎自行判断。

如果它对你有帮助，分享、测试和反馈都能帮到我们。如果有什么可以改进，提交问题更有用。如果你用它构建了什么，欢迎发邮件告诉我们：[email protected]。这真的会让我们开心一整天。

来自马略卡岛帕尔马的一间小工作室。

为什么

通过 AI 助手管理电子邮件、日历、消息、搜索和图像生成，通常意味着要使用五到六个独立的 MCP 服务，每个都要单独安装、完成 OAuth 授权流程并配置 API 密钥。本项目将它们整合到一个服务中，在你的笔记本电脑上运行。

一切都保留在本地。凭据存储在 ~/.personal-suite/config.json 中，权限为 0600，静态数据使用 AES-256-GCM 加密。唯一会离开你设备的数据，是直接发送给你所配置服务提供商的 API 调用。无需注册、无后端，也没有租户数据库。

自带 Brave、Exa、Tavily、OpenAI、Gemini 等服务的密钥（BYOK）。 消息功能使用你自己的 Bot Token（Telegram 使用 BotFather，Discord 使用开发者门户，Slack 使用应用等）。电子邮件支持 Gmail/Outlook OAuth，或带有自动发现功能的纯 IMAP，可覆盖 30,000 多家服务提供商。

快速开始

# Claude Desktop: add to claude_desktop_config.json
{
  "mcpServers": {
    "personal-suite": {
      "command": "npx",
      "args": ["-y", "mcp-personal-suite"]
    }
  }
}

# Claude Code
claude mcp add personal-suite -- npx -y mcp-personal-suite

# Cursor: same stdio command as Claude

然后在聊天中：

"What's configured?"                         → suite_status
"Show me the quickstart guide"               → suite_guide
"Set up email for [email protected]"          → suite_setup (module: email)
"What's on my calendar today?"               → calendar_list_events
"Send a Telegram to the team"                → channel_send

首次设置向导（可选，用于 Google OAuth）：

npx mcp-personal-suite setup

49 个工具，6 个模块

邮件 — email_*（15 个工具）

Gmail OAuth2、Outlook OAuth2、通用 IMAP/SMTP。自动发现 3 万多个 服务商（Gmail、Outlook、Yahoo、iCloud、WEB.DE、GMX、T-Online、mailbox.org、 Posteo、IONOS、Strato、Fastmail、ProtonMail Bridge 等）。附件最大支持 25 MB，并提供路径遍历防护。

email_status    email_setup       email_auth       email_list       email_read
email_send      email_reply       email_forward    email_search     email_threads
email_move      email_mark_read   email_mark_unread  email_delete   email_folders

日历 — calendar_*（11 个工具）

Google Calendar（OAuth2）和 CalDAV（Apple iCloud、Nextcloud、mailbox.org、 Posteo、Radicale，以及任意 CalDAV 服务）。活动、可用时间、冲突检测、 Meet 链接、每日摘要。与服务商无关：两者使用相同的工具。

calendar_status            calendar_list_events         calendar_get_event
calendar_create_event      calendar_update_event        calendar_delete_event
calendar_search_events     calendar_list_calendars      calendar_check_availability
calendar_upcoming          calendar_daily_summary

消息 — channel_*（8 个工具）

Telegram（grammy）、Discord（discord.js）、Slack（@slack/bolt）、WhatsApp（Baileys）。 使用你自己的机器人令牌。发送、接收、广播、历史记录。

关于 WhatsApp 的提示： Baileys 是一个非官方的逆向工程客户端。 它可以正常工作，但存在供应链风险，而且 WhatsApp 一旦更改协议，它就可能无法使用。 对于任何生产环境关键用途，请改用官方的 WhatsApp Business API（WABA）。 Baileys 适合个人使用或尝试。

channel_status    channel_send       channel_receive     channel_list
channel_connect   channel_disconnect channel_broadcast   channel_history

搜索 — search_*（7 个工具）

多服务商网关（自带 API 密钥）：SearXNG（可自托管）、Brave、Exa（神经搜索）、 Tavily（带引用的研究）。网页、新闻、图片、深度研究、语义搜索、 代码上下文。

search_web      search_news          search_images   search_deep
search_semantic search_code_context  search_research

图像 — image_*（3 个工具）

自带 API 密钥的图像生成：OpenAI DALL-E 3、通过 fal.ai 提供的 Flux（照片级真实感）、 Google Gemini Imagen 3（产品图）。根据提示词类型自动路由。

image_generate   image_edit   image_download

系统 — suite_*（5 个工具）

入门引导、状态、设置向导、运行状况检查、内嵌文档、GDPR 删除（按模块删除或彻底清除）。

suite_status   suite_setup   suite_health   suite_guide   suite_delete

配置

凭据保存在单个 JSON 文件中：

• macOS / Linux： ~/.personal-suite/config.json
• Windows： %USERPROFILE%\.personal-suite\config.json

权限强制设为 0600（仅所有者可读写）。敏感字段 （密码、令牌、密钥、API 密钥）在写入前会使用 AES-256-GCM 加密。 首次运行时会在 ~/.personal-suite/.key 中自动生成加密密钥；你也可以通过 CREDENTIAL_ENCRYPTION_KEY 环境变量提供自己的密钥（32 字节，base64）。

除你主动配置的服务商 API 直接调用外，任何数据都不会离开你的设备。

隐私

• 无需注册、无需账户、无遥测。
• 在配置模块之前，不会发送任何出站请求。
• 凭据静态加密，文件权限为 0600。
• suite_delete(module: "all", confirm: true) 会清除所有内容。
• 采用 MIT 许可证。阅读源代码。你可以按需分叉。

开发

git clone https://github.com/studiomeyer-io/mcp-personal-suite.git
cd mcp-personal-suite
npm install
npm run build
npm test             # ~400 tests, runs in under 5s
npm run dev          # watch-mode stdio
npm run start:http   # HTTP transport on :5120

HTTP 传输（可自托管）

如果你需要在局域网中为多个客户端运行长期服务：

mcp-personal-suite --http --port=5120

将 MCP 客户端指向 http://localhost:5120/mcp。使用带会话管理的 Streamable HTTP。 如果要让它可从 localhost 以外访问，请将其置于你自己的反向代理之后。

HTTP 模式的安全默认设置：

• MCP_ALLOWED_ORIGINS — 以逗号分隔的来源允许列表，供基于浏览器的 MCP 客户端使用。未设置时不接受任何跨源请求（最安全）。示例： MCP_ALLOWED_ORIGINS=http://localhost:3000,https://my-client.example.com。
• MCP_MAX_SESSIONS — 并发会话上限（默认值为 100）。超过上限后返回 503 Retry-After: 60。
• MCP_HOST — 绑定地址（默认值为 127.0.0.1）。只有确实需要在网络上 公开 MCP 服务时，才将其更改为 0.0.0.0。

Docker

docker build -t personal-suite .
docker run -d --network host \
  -v $HOME/.personal-suite:/home/node/.personal-suite \
  -e MCP_HTTP=1 -e MCP_PORT=5120 \
  personal-suite

技术

• TypeScript 严格模式，不使用 any，无循环依赖
• @modelcontextprotocol/sdk@^1.26.0
• imapflow（支持自动重连的异步 IMAP）、nodemailer（SMTP）
• googleapis（Gmail + Calendar OAuth）
• ts-caldav（Apple iCloud、Nextcloud、Radicale）
• grammy、discord.js、@slack/bolt、@whiskeysockets/baileys
• 使用 vitest 进行测试，支持 stdio 和 Streamable HTTP 双传输

相关项目

• local-memory-mcp — 为 Claude、Cursor、Codex 提供持久化本地记忆。与此项目搭配使用效果很好。
• mcp-video — 影院级视频 制作（ffmpeg + Playwright）。
• agent-fleet — 为 Claude Code 提供多 Agent 编排。
• ai-shield — TypeScript 的大模型安全工具 （提示词注入、PII、成本控制）。
• darwin-agents — 通过 A/B 测试实现提示词自我演进。

关于 StudioMeyer

StudioMeyer 是一家位于马略卡岛帕尔马的 AI 与设计工作室，为全球客户提供服务。我们为中小企业打造定制网站和 AI 基础设施。生产技术栈基于 Claude Agent SDK、MCP 和 n8n，并使用 Sentry、Langfuse 和 LangGraph 进行可观测性管理，同时配备自研防护层。

许可证

MIT。由 StudioMeyer 打造。