Remote MCP

🚀 遠程 MCP 服務器

這是一個基於 Cloudflare Worker 的 MCP（模型上下文協議）服務器，可提供各類工具 API，涵蓋 Gmail、Google Calendar 等實用功能。本項目採用 TypeScript 開發，並藉助 @remote - mcp/server 庫簡化 MCP 服務器的實現。

🚀 快速開始

本項目是基於 Cloudflare Workers 的無服務架構 MCP 服務器，提供了 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 命名空間配置

對於生產環境，你需要配置 KV 命名空間來存儲 OAuth 令牌：

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. Fork 倉庫：在 GitHub 上 Fork 此項目。
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.