Joseph19820124/pahud-mcp-cloudflare

AWS 文档 MCP 服务器 - Cloudflare 容器版

项目简介

这是一个在 Cloudflare 无服务器容器平台上运行的 AWS 文档 MCP（模型上下文协议）服务器的工作容器化实现。

功能特性

• 搜索 AWS 文档：返回真实的 AWS 文档 URL 和内容，支持任何搜索查询
• MCP 协议：为 AI 助手提供访问 AWS 文档的标准接口
• 实时访问：获取最新的 AWS 文档页面并转换为 markdown 格式

关键成就

我们成功解决了阻碍功能正常工作的关键容器部署问题：

• 问题：wrangler deploy --config 失败，错误为 "Cloudchamber account failed: Unauthorized"
• 解决方案：必须使用 npm run deploy 才能成功创建容器
• 结果：容器现在出现在 Cloudflare 控制台中，AWS MCP 服务器工作完美

架构设计

• Cloudflare Worker：处理 MCP 协议并充当代理
• Cloudflare Container：运行官方 AWS MCP 服务器子进程
• HTTP 包装器：桥接 Worker 和容器之间的通信

当前状态

✅ 完全功能：在线地址 https://xxxx.yyyy.workers.dev/mcp
✅ 生产就绪：兼容 Claude Desktop、Cursor、Windsurf
✅ 真实结果：返回真实的 AWS 文档 URL（非模拟数据）

使用示例

# 使用任何 MCP 客户端连接
npx mcp-remote https://xxxx.yyyy.workers.dev/mcp --transport http-only

该项目展示了如何使用 Cloudflare 容器平台成功部署复杂的 MCP 服务器，同时保持与官方 AWS MCP 实现的兼容性。

快速开始

前置要求

• Node.js 18+ 和 npm
• 具有 Workers 和 Container 访问权限的 Cloudflare 账户
• 全局安装的 Wrangler CLI

安装

# 克隆仓库
git clone https://github.com/yourusername/pahud_mcp.git
cd pahud_mcp

# 安装依赖
npm install

# 设置 Cloudflare 认证
npx wrangler login

配置

1. 复制示例配置：

cp wrangler.example.toml wrangler.toml

2. 使用您的 Cloudflare 账户详细信息更新 wrangler.toml

部署

# 部署到 Cloudflare（必须使用 npm 脚本）
npm run deploy

重要提示：不要直接使用 wrangler deploy --config，因为它会因授权错误而失败。始终使用 npm 脚本。

测试

# 本地测试
npm run dev

# 测试已部署版本
npm test

功能特性

• 🔍 完整的 AWS 文档搜索：访问所有 AWS 服务文档
• 🚀 无服务器架构：在 Cloudflare 边缘网络上运行
• 🔄 实时更新：始终返回最新文档
• 🛡️ 安全：在隔离的容器环境中运行
• 📦 易于集成：与任何兼容 MCP 的客户端配合使用

贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

许可证

本项目采用 MIT 许可证 - 查看 文件了解详情。

致谢

• AWS MCP Server - 官方 AWS 文档 MCP 服务器
• Model Context Protocol - MCP 协议规范
• Cloudflare Workers - 无服务器计算平台