mcp by masa162 - MCP Server

MCP統合プロジェクト

Claude DesktopからスケジュールアプリとメモアプリをAI操作できる統合MCPサーバー

📖 目次

概要
プロジェクト構成
クイックスタート
使い方
技術詳細
トラブルシューティング

概要

これは何？

このプロジェクトは、Claude Desktop（AIチャットツール）から自作の2つのアプリを操作できるようにするMCPサーバーです。

対象アプリケーション

A_スケジュールアプリ (dashboze): カレンダー・イベント管理
B_メモアプリ (stuck): Markdown形式のメモ・記事管理

何ができる？

Claude Desktopで自然言語で以下のような指示ができます：

今週の予定を教えて

明日の午後3時にミーティングを追加して

過去のメモから「AI」に関連する記事を検索して

この週報をメモに保存して：
# 今週の振り返り
...

プロジェクト構成

D:\github\mcp\
├── unified-mcp-server\        # 統合MCPサーバー（本プロジェクトの成果物）
│   ├── src\                   # ソースコード
│   │   ├── index.ts          # メインエントリポイント
│   │   ├── db\               # データベース操作
│   │   ├── tools\            # MCPツール定義
│   │   ├── modules\          # ビジネスロジック
│   │   └── utils\            # ユーティリティ
│   ├── package.json
│   ├── wrangler.toml         # Cloudflare設定
│   └── README.md             # 技術詳細
│
├── docs\                      # ドキュメント
│   ├── 実装計画書.md
│   ├── 実装ステップ.md
│   ├── デプロイ完了報告書.md
│   └── AI連携のための「MCPサーバー」2.md
│
└── README.md                  # このファイル

外部（参照のみ）:
D:\github\dashboze\            # スケジュールアプリ
D:\github\stuck\               # メモアプリ

クイックスタート

前提条件

✅ Windows 11
✅ Claude Desktop または Claude Code (VS Code拡張) がインストール済み
✅ 統合MCPサーバーが既にデプロイ済み

セットアップ

🖥️ Claude Desktop で使う場合（5分）

ステップ1: Claude Desktop設定ファイルを開く

Windowsエクスプローラーで以下のパスを開く：

%APPDATA%\Claude\

ステップ2: 設定ファイルを編集

claude_desktop_config.json ファイルを開く（なければ新規作成）。

以下を追加：

{
  "mcpServers": {
    "unified-mcp": {
      "url": "https://unified-mcp.belong2jazz.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer Uj+dXgb95mGSD0ruDY/lGb9KOsruowW3LffP7YrHcDo="
      }
    }
  }
}

⚠️ 重要: このAPIキーは秘密情報です。他人と共有しないでください。

ステップ3: Claude Desktopを再起動

Claude Desktopを完全に終了し、再度起動します。

ステップ4: 動作確認

Claude Desktopで以下を試してください：

今週の予定を教えて

正常に動作すれば、スケジュールアプリのデータが返ってきます！🎉

💻 Claude Code (VS Code) で使う場合（10分）

詳細はを参照してください。

簡易手順:

プロキシスクリプトが存在することを確認:
```
D:\github\mcp\unified-mcp-server\proxy.js
```

Claude Code設定ファイルを開く:

%APPDATA%\Code\User\globalStorage\anthropic.claude-code\settings\cline_mcp_settings.json

以下を追加:

{
  "mcpServers": {
    "unified-mcp": {
      "command": "node",
      "args": ["D:\\github\\mcp\\unified-mcp-server\\proxy.js"]
    }
  }
}

VS Code を再起動

詳細な手順とトラブルシューティングはを参照。

使い方

スケジュール操作

予定を確認する

今週の予定を教えて

来週月曜日の予定は？

予定を追加する

明日の午後3時から4時までミーティングを追加して。場所は「会議室A」、タグは「仕事」

2025年1月20日の終日で「有給休暇」を登録して

予定を検索する

「プロジェクト」に関連する予定を検索して

予定を更新・削除する

イベントID 5 の予定を削除して

イベントID 10 の場所を「オンライン」に変更して

メモ操作

メモを検索する

最新のメモを5件取得して

「AI」タグが付いたメモを検索して

「機械学習」というキーワードを含むメモを探して

メモを保存する

この内容をメモに保存して：
# 今日の学び
- MCPサーバーについて理解した
- Cloudflare Workersの使い方を学んだ

タイトルは「週報 2025-01-15」、タグは「振り返り」「業務」で以下をメモして：
...

メモを取得する

記事ID 3 の詳細を教えて

メモを削除・復元する

記事ID 8 を削除して

記事ID 8 を復元して

タグ一覧を確認する

利用可能なタグ一覧を教えて

連携活用例

MCPサーバーの真の価値は、複数アプリ間での連携です。

例1: メモからスケジュールを作成

過去のメモから「プロジェクトX」に関連する内容を読み取って、
それを元に来週のタスクをスケジュールに登録して

例2: スケジュールから週報を作成

今週の予定実績を確認して、週報をMarkdown形式でメモに保存して

例3: PDCA サイクル

先週の週報メモを読んで、そこから改善点を抽出し、
今週のスケジュールに反映させて

技術詳細

アーキテクチャ

Claude Desktop (AIクライアント)
    ↓ HTTPS (Bearer Token認証)
統合MCPサーバー (Cloudflare Workers)
    ↓
    ├─→ Cloudflare D1: dashboze-calendar (スケジュールDB)
    └─→ Cloudflare D1: stuck-db (メモDB)

利用可能なツール（全11個）

スケジュール系（5個）

ツール名	説明
`schedule_create_event`	イベント作成
`schedule_list_events`	イベント一覧取得
`schedule_update_event`	イベント更新
`schedule_delete_event`	イベント削除
`schedule_search_events`	イベント全文検索

メモ系（6個）

ツール名	説明
`memo_search_articles`	メモ検索
`memo_get_article`	メモ詳細取得
`memo_save_article`	メモ保存（新規・更新）
`memo_delete_article`	メモ削除（ゴミ箱へ）
`memo_restore_article`	ゴミ箱から復元
`memo_list_tags`	タグ一覧取得

デプロイ情報

URL: https://unified-mcp.belong2jazz.workers.dev
プラットフォーム: Cloudflare Workers
データベース: Cloudflare D1 (SQLite)
認証: Bearer Token (APIキー)

トラブルシューティング

Q1: Claude Desktopで「ツールが見つからない」と言われる

解決策:

claude_desktop_config.json の設定を確認
Claude Desktopを完全に再起動（タスクトレイからも終了）
設定ファイルのJSON形式が正しいか確認（カンマ、括弧など）

Q2: 「認証エラー」が発生する

解決策:

APIキーが正しくコピーされているか確認
余分なスペースや改行が入っていないか確認
Authorization: Bearer の後にスペースがあるか確認

Q3: 「予定が見つからない」と言われる

原因:

スケジュールアプリ（dashboze）のデータベースが空の可能性

解決策:

まず予定を1つ作成してみる：「明日の午前10時にテストイベントを追加して」

Q4: メモが保存できない

原因:

メモアプリ（stuck）のデータベーススキーマの問題

解決策:

タイトルとコンテンツを必ず指定する
長すぎる内容は分割して保存

Q5: 動作が遅い

原因:

Cloudflare Workers のコールドスタート
データベースクエリの複雑さ

対策:

初回アクセスは遅いが、2回目以降は高速化します
検索範囲を絞る（日付範囲、タグなど）

セキュリティ

APIキーの管理

⚠️ 重要な注意事項:

APIキーは秘密情報です。以下のように扱ってください：
- 他人と共有しない
- GitHubなどに公開しない
- スクリーンショットに含めない

APIキーが漏洩した場合:

cd D:\github\mcp\unified-mcp-server
wrangler secret put MCP_API_KEY
# 新しいAPIキーを入力

その後、claude_desktop_config.json も更新してください。

データのプライバシー

すべてのデータはあなた専用のCloudflareアカウント内に保存されます
第三者がアクセスすることはできません
Claudeとの対話ログは、MCPサーバーには保存されません

よくある質問（FAQ）

Q: 他のアプリ（C、D...）も追加できますか？

A: はい、可能です。新しいモジュールを追加してデプロイするだけです。Claude Desktop側の設定変更は不要です。

Q: オフラインでも使えますか？

A: いいえ。MCPサーバーはCloudflare Workers上で動作するため、インターネット接続が必要です。

Q: 他のAIツール（ChatGPT等）でも使えますか？

A: 現在はClaude Desktop専用です。ただし、HTTPエンドポイントは一般的なREST APIとしても利用可能です。

Q: スマートフォンから使えますか？

A: Claude Desktopはデスクトップアプリケーションなので、PCからのみ利用可能です。ただし、curl等でAPIを直接呼び出すことは可能です。

Q: 料金はかかりますか？

A: Cloudflare Workersの無料枠内であれば無料です。大量のリクエストを行う場合は、Cloudflareの料金プランを確認してください。

更新履歴

v1.0.0 (2025-10-27)

✅ 初回リリース
✅ スケジュール系5ツール実装
✅ メモ系6ツール実装
✅ Cloudflare Workersへデプロイ完了

サポート・お問い合わせ

ドキュメント

- 詳細な設計情報
- デプロイ詳細
- 開発者向け情報

ログ確認

問題が発生した場合、以下のコマンドでログを確認できます：

cd D:\github\mcp\unified-mcp-server
wrangler tail unified-mcp

ライセンス

MIT License

作成者

プロジェクト管理: まさゆき
実装: Claude Code
作成日: 2025-10-27

MCPサーバーを使って、AIとの対話をさらに便利にしましょう！ 🚀