令人惊叹的Marvin远程MCP服务器
一个用于Amazing Marvin生产力系统的远程MCP（模型上下文协议）服务器，兼容Claude的移动和桌面应用程序。
✨ 特点/功能
- 28款生产力工具 - 所有原始的Amazing Marvin MCP工具已移植到远程版本
- 移动设备兼容 - 与Claude移动应用（iOS/Android）兼容
- OAuth 2.0 认证 - 使用动态客户端注册实现安全认证
- Cloudflare Workers（云防护网工作者） - 无服务器部署，结合全球边缘网络
- 缓存 - 智能缓存以提升性能
- 完整API覆盖 - 读/写操作、分析、时间追踪
🚀 快速入门
1. 先决条件
- Cloudflare账户
- 令人惊叹的Marvin API密钥
- Node.js 18+ 和 npm/yarn
2. 安装
# Clone and install dependencies
git clone
cd amazing-marvin-remote-mcp
npm install3. 配置
# Set up Wrangler CLI
npm install -g wrangler
wrangler login
# Create KV namespaces
wrangler kv:namespace create "CACHE"
wrangler kv:namespace create "TOKENS"
wrangler kv:namespace create "CACHE" --preview
wrangler kv:namespace create "TOKENS" --preview
# Update wrangler.toml with the namespace IDs
# Set secrets
wrangler secret put AMAZING_MARVIN_API_KEY
wrangler secret put OAUTH_CLIENT_SECRET # Generate a random string
wrangler secret put JWT_SECRET # Generate a random string4. 部署
# Development
npm run dev
# Production
npm run deploy5. 连接至Claude
- 前往 Claude.ai → 设置 → 连接器
- 添加自定义连接器
- 输入您的工作节点URL：
https://your-worker.your-subdomain.workers.dev - 使用您的Amazing Marvin API密钥进行授权
🛠️ 可用工具
读取操作（12种工具）
get_daily_productivity_overview- 全面的每日概览get_tasks- 今天的预定事项get_projects- 所有项目get_categories- 所有类别get_due_items- 已逾期/到期项目get_child_tasks- 子任务（具有递归选项）get_all_tasks- 所有任务（带标签过滤）get_labels- 任务标签get_goals- 目标和宗旨get_account_info- 账户详情get_completed_tasks- 已完成的项目get_completed_tasks_for_date- 在特定日期完成的项目
写入操作（10种工具）
create_task- 创建新任务mark_task_done- 完成任务create_project- 创建项目start_time_tracking- 开始计时stop_time_tracking- 停止时间追踪batch_mark_done- 完成多项任务batch_create_tasks- 创建多个任务create_project_with_tasks- 创建包含任务的项目quick_daily_planning- 生成每日计划概览get_daily_focus- 获取每日任务分类
分析运营（6种工具）
get_productivity_summary- 当前生产力概览get_productivity_summary_for_time_range- 时间范围分析get_project_overview- 项目完成指标get_time_tracking_summary- 时间跟踪数据get_done_items- 替代完成项检索get_time_tracks- 时间追踪记录
📱 手机设置指南
iOS/Android Claude 应用
- 首先在网页上进行配置
- 在您的浏览器中打开Claude.ai - 进入设置 → 连接器 → 添加自定义连接器 - 名字：“神奇的马文” - 网址： https://your-worker.your-subdomain.workers.dev
- 授权访问
- 点击“连接” - 当提示时，请输入您的Amazing Marvin API密钥 - 完整的OAuth流程
- 在手机上使用
- 设置自动同步到手机应用 - 开始在对话中使用Marvin工具
示例用法
Claude, what's my daily productivity overview?
Claude, create a task "Review project proposal" scheduled for tomorrow
Claude, show me my project completion metrics🔧 开发
项目结构
src/
├── worker.ts # Main Cloudflare Worker
├── oauth.ts # OAuth 2.0 implementation
├── marvin-api.ts # Amazing Marvin API client
├── mcp-tools.ts # MCP tool implementations
├── types.ts # TypeScript types
└── config.ts # Tool definitions & config本地开发
# Start development server
npm run dev
# Type checking
npm run type-check
# Deploy to staging
wrangler deploy --env staging环境变量
通过 Wrangler 设置这些密钥：
AMAZING_MARVIN_API_KEY- 您的神奇Marvin API密钥OAUTH_CLIENT_SECRET- OAuth的随机密钥（使用crypto.randomUUID()生成）JWT_SECRET- 用于JWT签名的随机密钥（使用crypto.randomUUID()生成）
🔐 安全
- OAuth 2.0 - 行业标准认证
- JWT 令牌 - 安全、无状态的身份验证
- API密钥加密 用户API密钥安全存储
- CORS 保护 - 适当的跨域控制
- 速率限制 - 内置Cloudflare防护
🚨 故障排除
常见问题
- 无效的API密钥 - 在Amazing Marvin中检查您的Amazing Marvin API密钥：Amazing Marvin → 设置 → API
- “未找到工具” - 确保你使用的是上述列表中的确切工具名称
- “身份验证失败” - 在Claude设置中重新授权连接器
- KV 命名空间错误 - 验证 wrangler.toml 中的命名空间 ID 是否与您创建的命名空间匹配
调试模式
通过设置环境变量来启用调试模式：
wrangler secret put DEBUG_MODE
# Enter: true📊 性能
- 全球边缘网络 - 部署到200多个Cloudflare节点
- 智能缓存 - 对频繁访问的数据进行10分钟缓存
- 亚秒级响应 - 优化为适合移动设备使用
- 99.9%的正常运行时间 - Cloudflare的可靠性保证
🤝 贡献（或：参与贡献）
- 为仓库创建分支（或：克隆仓库）
- 创建你的特性分支：
git checkout -b feature/amazing-feature - 提交更改：
git commit -m 'Add amazing feature' - 推送到分支：
git push origin feature/amazing-feature - 提交一个拉取请求（或合并请求）
📄 许可证
MIT 许可证 - 详见 许可证 文件中有详细信息。
🙏 致谢
- 原文（Original） 惊人的马文MCP 由bgheneti（注：此处“bgheneti”可能是一个用户名或特定名称，根据上下文无法确定具体含义，故直接音译）
- 模型上下文协议 由Anthropic开发
- 神奇的马文 生产率系统
______________________________________________________________________
用心打造，献给了不起的Marvin和Claude社区