note.com MCP Server

# Cloudflare Tunnel を使った note-mcp-server のセットアップ ## 概要 このガイドでは、Cloudflare Tunnelを使用してローカルのnote-mcp-serverをVPS上のn8nから安全にアクセスできるようにする方法を説明します。 ### この構成のメリット - ✅ **セキュリティ**: note.comの認証情報はローカルPCに保持 - ✅ **24時間アクセス**: VPS上のn8nからいつでもアクセス可能 - ✅ **無料**: Cloudflare Tunnelは無料で利用可能 - ✅ **簡単**: 複雑なファイアウォール設定不要 - ✅ **安全**: 外部からの直接アクセスは不可能 ### アーキテクチャ ``` [ローカルPC] [Cloudflare] [VPS] note-mcp-server ←[Tunnel]→ Cloudflare Edge ←[HTTPS]→ n8n (localhost:3000) (セルフホスト) ``` ## 前提条件 - ローカルPC（macOS/Linux/Windows） - Cloudflareアカウント（無料） - Cloudflareで管理しているドメイン（オプション） - VPS上でn8nがセルフホスティングされている ## セットアップ手順 ### Step 1: Cloudflared のインストール #### macOS (Homebrew) ```bash brew install cloudflare/cloudflare/cloudflared ``` #### Linux ```bash # Debian/Ubuntu wget https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb sudo dpkg -i cloudflared-linux-amd64.deb # RHEL/CentOS wget https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-x86_64.rpm sudo rpm -i cloudflared-linux-x86_64.rpm ``` #### Windows [公式サイト](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/)からインストーラーをダウンロード ### Step 2: Cloudflareアカウントでログイン ```bash cloudflared tunnel login ``` ブラウザが開き、Cloudflareアカウントでの認証を求められます。認証後、証明書がローカルに保存されます。 ### Step 3: note-mcp-server のビルドと起動確認 ```bash cd /path/to/noteMCP npm install npm run build npm run start:http ``` 別のターミナルで動作確認： ```bash curl http://localhost:3000/health ``` 期待されるレスポンス： ```json { "status": "ok", "server": "note-api-mcp", "version": "2.0.0-http", "transport": "SSE", "authenticated": true } ``` ## 方法A: クイックトンネル（テスト用） 最も簡単な方法。一時的なURLが発行されます。 ```bash # note-mcp-serverが起動している状態で cloudflared tunnel --url http://localhost:3000 ``` 出力例： ``` 2024-01-01T12:00:00Z INF +--------------------------------------------------------------------------------------------+ 2024-01-01T12:00:00Z INF | Your quick Tunnel has been created! Visit it at (it may take some time to be reachable): | 2024-01-01T12:00:00Z INF | https://random-words-1234.trycloudflare.com | 2024-01-01T12:00:00Z INF +--------------------------------------------------------------------------------------------+ ``` ### n8nでの設定 **HTTP Stream URL:** ``` https://random-words-1234.trycloudflare.com/mcp ``` **注意:** このURLは起動ごとに変わります。テスト用途のみに使用してください。 ## 方法B: 永続的なトンネル（推奨） 独自ドメインを使用した永続的なトンネルを作成します。 ### Step 1: トンネルの作成 ```bash cloudflared tunnel create note-mcp ``` 出力例： ``` Tunnel credentials written to /Users/yourname/.cloudflared/12345678-1234-1234-1234-123456789abc.json Created tunnel note-mcp with id 12345678-1234-1234-1234-123456789abc ``` **重要:** トンネルIDとcredentialsファイルのパスをメモしてください。 ### Step 2: 設定ファイルの作成 ```bash mkdir -p ~/.cloudflared nano ~/.cloudflared/config.yml ``` 以下の内容を記述（トンネルIDとパスは実際の値に置き換えてください）： ```yaml tunnel: 12345678-1234-1234-1234-123456789abc credentials-file: /Users/yourname/.cloudflared/12345678-1234-1234-1234-123456789abc.json ingress: - hostname: note-mcp.your-domain.com service: http://localhost:3000 - service: http_status:404 ``` **設定項目の説明:** - `tunnel`: Step 1で作成したトンネルID - `credentials-file`: credentialsファイルの絶対パス - `hostname`: 使用するサブドメイン（Cloudflareで管理しているドメイン） - `service`: ローカルのnote-mcp-serverのURL ### Step 3: DNS設定 ```bash cloudflared tunnel route dns note-mcp note-mcp.your-domain.com ``` これにより、Cloudflareの DNS に自動的にCNAMEレコードが追加されます。 ### Step 4: トンネルの起動 ```bash cloudflared tunnel run note-mcp ``` 出力例： ``` 2024-01-01T12:00:00Z INF Starting tunnel tunnelID=12345678-1234-1234-1234-123456789abc 2024-01-01T12:00:00Z INF Connection registered connIndex=0 location=NRT 2024-01-01T12:00:00Z INF Connection registered connIndex=1 location=NRT ``` ### Step 5: 動作確認 ```bash curl https://note-mcp.your-domain.com/health ``` 期待されるレスポンス： ```json { "status": "ok", "server": "note-api-mcp", "version": "2.0.0-http", "transport": "SSE", "authenticated": true } ``` ### n8nでの設定 **HTTP Stream URL:** ``` https://note-mcp.your-domain.com/mcp ``` または ``` https://note-mcp.your-domain.com/sse ``` **HTTP Connection Timeout:** ``` 60000 ``` **Messages Post Endpoint:** （空欄） **Additional Headers:** （空欄） ## 自動起動設定 ### macOS (LaunchAgent) #### note-mcp-server の自動起動 ```bash # ログディレクトリ作成 mkdir -p ~/noteMCP/logs # LaunchAgent作成 nano ~/Library/LaunchAgents/com.note-mcp-server.plist ``` ```xml <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>com.note-mcp-server</string> <key>ProgramArguments</key> <array> <string>/usr/local/bin/node</string> <string>/Users/yourname/noteMCP/build/note-mcp-server-http.js</string> </array> <key>WorkingDirectory</key> <string>/Users/yourname/noteMCP</string> <key>RunAtLoad</key> <true/> <key>KeepAlive</key> <true/> <key>StandardOutPath</key> <string>/Users/yourname/noteMCP/logs/stdout.log</string> <key>StandardErrorPath</key> <string>/Users/yourname/noteMCP/logs/stderr.log</string> <key>EnvironmentVariables</key> <dict> <key>PATH</key> <string>/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string> </dict> </dict> </plist> ``` **重要:** `/usr/local/bin/node` と `/Users/yourname/noteMCP` は実際のパスに置き換えてください。 Node.jsのパスを確認： ```bash which node ``` ```bash # サービス登録・起動 launchctl load ~/Library/LaunchAgents/com.note-mcp-server.plist launchctl start com.note-mcp-server # ステータス確認 launchctl list | grep note-mcp-server # ログ確認 tail -f ~/noteMCP/logs/stdout.log ``` #### Cloudflare Tunnel の自動起動 ```bash nano ~/Library/LaunchAgents/com.cloudflared.note-mcp.plist ``` ```xml <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>com.cloudflared.note-mcp</string> <key>ProgramArguments</key> <array> <string>/opt/homebrew/bin/cloudflared</string> <string>tunnel</string> <string>run</string> <string>note-mcp</string> </array> <key>RunAtLoad</key> <true/> <key>KeepAlive</key> <true/> <key>StandardOutPath</key> <string>/Users/yourname/noteMCP/logs/cloudflared-stdout.log</string> <key>StandardErrorPath</key> <string>/Users/yourname/noteMCP/logs/cloudflared-stderr.log</string> </dict> </plist> ``` **重要:** cloudflaredのパスを確認してください： ```bash which cloudflared ``` Intel Macの場合は `/usr/local/bin/cloudflared` になる可能性があります。 ```bash # サービス登録・起動 launchctl load ~/Library/LaunchAgents/com.cloudflared.note-mcp.plist launchctl start com.cloudflared.note-mcp # ステータス確認 launchctl list | grep cloudflared # ログ確認 tail -f ~/noteMCP/logs/cloudflared-stdout.log ``` ### Linux (systemd) #### note-mcp-server の自動起動 ```bash sudo nano /etc/systemd/system/note-mcp-server.service ``` ```ini [Unit] Description=note MCP Server After=network.target [Service] Type=simple User=youruser WorkingDirectory=/home/youruser/noteMCP Environment="NODE_ENV=production" ExecStart=/usr/bin/node /home/youruser/noteMCP/build/note-mcp-server-http.js Restart=always RestartSec=10 [Install] WantedBy=multi-user.target ``` ```bash sudo systemctl daemon-reload sudo systemctl enable note-mcp-server sudo systemctl start note-mcp-server sudo systemctl status note-mcp-server ``` #### Cloudflare Tunnel の自動起動 ```bash sudo cloudflared service install sudo systemctl enable cloudflared sudo systemctl start cloudflared sudo systemctl status cloudflared ``` ### Windows (タスクスケジューラ) 1. タスクスケジューラを開く 2. 「基本タスクの作成」を選択 3. トリガー: 「コンピューターの起動時」 4. 操作: 「プログラムの起動」 5. プログラム/スクリプト: `node.exe` のパス 6. 引数: `C:\path\to\noteMCP\build\note-mcp-server-http.js` 7. 開始: `C:\path\to\noteMCP` Cloudflare Tunnelも同様に設定します。 ## n8nワークフロー例 ### 例1: 定期的な記事検索とSlack通知 ```json { "name": "Note記事検索 → Slack通知", "nodes": [ { "parameters": { "rule": { "interval": [{"field": "hours", "hoursInterval": 6}] } }, "name": "6時間ごと", "type": "n8n-nodes-base.scheduleTrigger", "position": [250, 300] }, { "parameters": { "url": "https://note-mcp.your-domain.com/mcp", "transport": "sse", "tool": "search-notes", "toolParameters": { "query": "プログラミング", "size": 5, "sort": "new" } }, "name": "Note記事検索", "type": "n8n-nodes-mcp.mcpClient", "position": [450, 300] }, { "parameters": { "channel": "#note-updates", "text": "新着記事が見つかりました:\n{{ $json.notes }}" }, "name": "Slack通知", "type": "n8n-nodes-base.slack", "position": [650, 300] } ] } ``` ### 例2: Webhook経由で記事投稿 ```json { "name": "Webhook → Note下書き投稿", "nodes": [ { "parameters": { "path": "note-post" }, "name": "Webhook", "type": "n8n-nodes-base.webhook", "position": [250, 300] }, { "parameters": { "url": "https://note-mcp.your-domain.com/mcp", "transport": "sse", "tool": "post-draft-note", "toolParameters": { "title": "={{ $json.body.title }}", "body": "={{ $json.body.content }}" } }, "name": "Note下書き投稿", "type": "n8n-nodes-mcp.mcpClient", "position": [450, 300] } ] } ``` ## トラブルシューティング ### トンネルに接続できない ```bash # トンネルのステータス確認 cloudflared tunnel info note-mcp # トンネル一覧表示 cloudflared tunnel list # DNS設定確認 dig note-mcp.your-domain.com ``` ### note-mcp-serverが起動しない ```bash # macOS: ログ確認 tail -f ~/noteMCP/logs/stderr.log # Linux: ログ確認 sudo journalctl -u note-mcp-server -f # 手動起動でテスト cd ~/noteMCP npm run start:http ``` ### n8nから接続できない 1. ローカルでヘルスチェック： ```bash curl http://localhost:3000/health ``` 2. Cloudflare Tunnel経由でヘルスチェック： ```bash curl https://note-mcp.your-domain.com/health ``` 3. n8nのログを確認： ```bash # n8nのログ確認（VPS上で） docker logs -f n8n # Dockerの場合 pm2 logs n8n # PM2の場合 ``` ### 自動起動が動作しない（macOS） ```bash # サービスのステータス確認 launchctl list | grep note-mcp launchctl list | grep cloudflared # サービスの再起動 launchctl stop com.note-mcp-server launchctl start com.note-mcp-server # サービスの削除と再登録 launchctl unload ~/Library/LaunchAgents/com.note-mcp-server.plist launchctl load ~/Library/LaunchAgents/com.note-mcp-server.plist ``` ### Cloudflareダッシュボードでの確認 1. [Cloudflare Zero Trust](https://one.dash.cloudflare.com/) にログイン 2. 「Access」→「Tunnels」でトンネルのステータスを確認 3. 「Healthy」と表示されていればOK ## セキュリティに関する注意 ### メリット - ✅ 認証情報はローカルPCに保持 - ✅ 外部からの直接アクセスは不可能 - ✅ Cloudflareの保護下で動作 - ✅ DDoS攻撃からの保護 ### 追加の保護（オプション） #### Cloudflare Access でIP制限 1. [Cloudflare Zero Trust](https://one.dash.cloudflare.com/) にログイン 2. 「Access」→「Applications」→「Add an application」 3. 「Self-hosted」を選択 4. Application domain: `note-mcp.your-domain.com` 5. Policy: VPSのIPアドレスのみ許可 ``` Policy name: n8n VPS Only Action: Allow Include: IP ranges → VPSのIPアドレス ``` これにより、VPS以外からのアクセスをブロックできます。 ## まとめ ### 推奨構成 ``` [ローカルPC] ├── note-mcp-server (自動起動) │ └── localhost:3000 └── Cloudflare Tunnel (自動起動) └── note-mcp.your-domain.com ↓ [Cloudflare Edge] ↓ [VPS: n8n] ``` ### チェックリスト - [ ] Cloudflaredインストール完了 - [ ] Cloudflareアカウントでログイン完了 - [ ] トンネル作成完了 - [ ] 設定ファイル作成完了 - [ ] DNS設定完了 - [ ] note-mcp-server自動起動設定完了 - [ ] Cloudflare Tunnel自動起動設定完了 - [ ] ヘルスチェック成功 - [ ] n8nから接続成功 ### サポート 問題が発生した場合は、以下を確認してください： 1. [Cloudflare Tunnel ドキュメント](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/) 2. [note-mcp-server GitHub Issues](https://github.com/note-mcp-developer/note-mcp-server/issues) 3. ログファイル（`~/noteMCP/logs/`） この構成により、セキュアで安定したnote自動化環境が構築できます！