hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables deployment of the MCP server on Cloudflare Workers, providing a remote environment for hosting MCP tools with OAuth authentication.

Remote MCP 服务器

这是一个基于Cloudflare Worker的MCP (Model Context Protocol) 服务器，用于提供各种工具API，包括Gmail、Google Calendar等功能。该项目使用TypeScript开发，并使用@remote-mcp/server库来简化MCP服务器的实现。

功能特点

基于 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 配置

在 Google Cloud Console 创建一个项目
启用 Gmail API 和 Google Calendar API
创建 OAuth 客户端ID和密钥
修改 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令牌：

在Cloudflare Dashboard创建KV命名空间
获取KV命名空间ID
取消注释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 - Gmail OAuth认证
/oauth/gmail/callback - Gmail OAuth回调

故障排除

常见问题

部署错误 - KV命名空间无效: 确保在wrangler.jsonc中配置了正确的KV命名空间ID，或者暂时注释掉KV配置部分进行测试部署
OAuth错误: 检查重定向URI是否正确配置在Google Cloud Console和项目配置中
编译错误: 确保TypeScript配置中noEmit设置为false，允许生成JavaScript文件

日志和调试

使用Cloudflare Workers控制台查看日志和调试信息。

贡献指南

Fork仓库
创建功能分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m 'Add some amazing feature')
推送到分支 (git push origin feature/amazing-feature)
创建Pull Request

许可证

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

A server for hosting Model Context Protocol (MCP) tools on Cloudflare Workers with OAuth authentication, allowing Claude AI and other MCP clients to access extended capabilities.

Appeared in Searches

An MCP that supports the SSE communication protocol for testing purposes