Remote MCP

🚀 リモート MCP サーバー

このプロジェクトは、Cloudflare Worker をベースにした MCP (Model Context Protocol) サーバーです。Gmail や Google Calendar など、様々なツール API を提供します。TypeScript で開発されており、@remote - mcp/server ライブラリを使用して MCP サーバーの実装を簡素化しています。

🚀 クイックスタート

このリモート MCP サーバーは、Cloudflare Workers 上で動作する無サーバーアプリケーションです。Gmail や Google Calendar の API を利用した機能を提供します。以下の手順でセットアップしてください。

✨ 主な機能

• Cloudflare Workers ベースのサーバーレスアーキテクチャ
• Gmail のメール送信と読み取り機能を提供
• Google Calendar のイベント作成と一覧表示機能を提供
• OAuth2 認証を統合
• Durable Objects を使用した状態管理

📦 インストール

# リポジトリをクローン
git clone https://github.com/yourusername/remote-mcp-server.git
cd remote-mcp-server

# 依存関係をインストール
npm install

📚 ドキュメント

設定

OAuth 設定

1. Google Cloud Console でプロジェクトを作成します。
2. Gmail API と Google Calendar API を有効にします。
3. OAuth クライアント ID とシークレットを作成します。
4. src/config.ts ファイルの OAuth 設定を変更します。

export const GOOGLE_OAUTH_CONFIG = {
  clientId: '你的客户端 ID',
  clientSecret: '你的客户端密钥',
  redirectUri: 'https://your-worker.your-subdomain.workers.dev/oauth/gmail/callback',
  scopes: [
    'https://www.googleapis.com/auth/gmail.send',
    'https://www.googleapis.com/auth/gmail.readonly',
    'https://www.googleapis.com/auth/calendar',
    'https://www.googleapis.com/auth/calendar.events'
  ]
};

Cloudflare KV 名前空間設定

本番環境では、OAuth トークンを保存するために KV 名前空間を設定する必要があります。

1. Cloudflare Dashboard で KV 名前空間を作成します。
2. KV 名前空間 ID を取得します。
3. wrangler.jsonc の KV 設定部分のコメントを解除し、名前空間 ID を追加します。

"kv_namespaces": [
  {
    "binding": "OAUTH_KV",
    "id": "你的 KV 命名空间 ID"
  }
]

ビルドとデプロイ

ローカル開発

# 開発サーバーを起動
npm run dev

Cloudflare Workers にデプロイ

# ビルドしてデプロイ
npm run deploy

プロジェクト構造

remote-mcp-server/
├── src/                  # ソースコード
│   ├── index.ts          # メインエントリーファイル
│   ├── config.ts         # 設定ファイル
│   ├── services/         # サービス実装
│   │   └── google.ts     # Google サービス (Gmail, Calendar)
│   └── utils.ts          # ユーティリティ関数
├── dist/                 # コンパイル後のファイル
├── static/               # 静的リソース
├── build.js              # ビルドスクリプト
└── wrangler.jsonc        # Cloudflare Workers 設定

API エンドポイント

• /tools - 利用可能なツールのリストを取得
• /api/mcp - MCP API エンドポイント
• /oauth/gmail - OAuth ログインパス
• /oauth/callback - OAuth コールバック処理パス

トラブルシューティング

一般的な問題

1. デプロイエラー：KV 名前空間が正しく設定されているか確認してください。
2. OAuth エラー：リダイレクト URI が Google Cloud Console の設定と一致していることを確認してください。
3. Durable Objects の問題：Durable Objects が正しく初期化され、アクセス権限があることを確認してください。

解決策

1. デプロイエラー：
   • wrangler.jsonc に正しい KV 名前空間 ID が記載されていることを確認します。
   • Cloudflare アカウントで KV ストレージサービスが有効になっていることを確認します。
2. OAuth エラー：
   • Google Cloud Console で、許可されたリダイレクト URI に設定したパスが含まれていることを確認します。
   • クライアント ID とシークレットが正しく記載されていることを確認します。
3. Durable Objects の問題：
   • コードで Durable Object が正しく初期化され、関連リソースにアクセスする権限があることを確認します。

コントリビューションガイド

1. リポジトリをフォーク：GitHub でこのプロジェクトをフォークします。
2. 機能ブランチを作成：メインブランチをベースに新しい機能や修正用のブランチを作成します。
3. コードをコミット：変更をコミットし、リモートリポジトリにプッシュします。
4. Pull Request を作成：元のプロジェクトのリポジトリで Pull Request を作成します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は以下の通りです。

MIT License

Copyright (c) [年份] [作者姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

このプロジェクトにご関心をいただき、ありがとうございます！何か質問や提案があれば、いつでもプロジェクトのメンテナにご連絡ください。