Personal Suite

StudioMeyer MCP Stack の一部 — マヨルカ島で開発 🌴 · ご利用の際は ⭐ をお願いします

---

私たちからひと言

私たちは過去 2 年間、自分たちのためにツールやシステムを作ってきました。このリポジトリが小さく、スターが少ないのは、新しいからではありません。これまで作ってきたものを共有しようと決めたのが、つい最近だからです。新たに始めた実験ではなく、最近のコミットへと続く長い歩みです。

私たちはものを作り、共有することが大好きです。ソーシャルメディアの戦術や成長ハック、スターやフォロワー集めは好みません。そのため、このリポジトリは小規模です。コードは実際に使われており、問題にも対応しています。ぜひご自身で判断してください。

役に立ったら、共有やテスト、フィードバックで応援していただけるとうれしいです。改善の余地があれば、Issue を立てていただくのが一番役立ちます。これを使って何か作ったら、[email protected] までお知らせください。本当にうれしいです。

マヨルカ島パルマの小さなスタジオより。

このプロジェクトについて

メール、カレンダー、メッセージング、検索、画像生成を AI アシスタントから利用するには、通常、それぞれ個別にインストールや OAuth 認証、API キーが必要な 5〜6 個の MCP サーバーを使うことになります。このサーバーはそれらすべてを 1 つにまとめ、 お使いのノートパソコン上で実行します。

すべてのデータはローカルに保たれます。認証情報は ~/.personal-suite/config.json に 0600 の権限で保存され、保存時には AES-256-GCM で暗号化されます。お使いのマシンから外部に送信されるデータは、設定したプロバイダーへの直接 API 呼び出しだけです。 登録不要、バックエンドなし、テナントデータベースもありません。

Brave、Exa、Tavily、OpenAI、Gemini などの API キーはご自身で用意してください（BYOK）。 メッセージングには、ご自身のボットトークンを使用します（Telegram の BotFather、Discord の開発者ポータル、Slack アプリなど）。メールには Gmail／Outlook OAuth、または 30,000 以上のプロバイダーを自動検出する通常の IMAP を使用します。

クイックスタート

# 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。30K 以上のプロバイダー（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 ツール）

複数プロバイダー対応のゲートウェイ（BYOK）：SearXNG（セルフホスト）、Brave、Exa（ニューラル検索）、Tavily（引用付きリサーチ）。ウェブ、ニュース、画像、詳細リサーチ、セマンティック検索、コードコンテキストに対応します。

search_web      search_news          search_images   search_deep
search_semantic search_code_context  search_research

画像 — image_*（3 ツール）

BYOK による画像生成：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 トランスポート（セルフホスト）

LAN 上の複数のクライアント向けに長時間稼働するサーバーが必要な場合：

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）。ネットワーク上にサーバーを公開する場合に限り、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 strict、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 向けのマルチエージェント オーケストレーションです。
• ai-shield — TypeScript 向けの LLM セキュリティです （プロンプトインジェクション、PII、コスト管理）。
• darwin-agents — A/B テストによる自己進化型プロンプトです。

StudioMeyer について

StudioMeyer は、パルマ・デ・マヨルカを拠点に世界中のクライアントと仕事をする、AI とデザインのスタジオです。中小企業向けのカスタムウェブサイトと AI インフラストラクチャを構築しています。Claude Agent SDK、MCP、n8n を使った本番環境向けスタックに、オブザーバビリティ用の Sentry、Langfuse、LangGraph と、社内開発のガードレイヤーを組み合わせています。

ライセンス

MIT。StudioMeyer が開発しました。