Reclaim.ai MCP服务器🚀 _（非官方）_
⚠️ 非官方&无关联 这个项目是 不 Reclaim.ai认可、赞助或支持。它只使用Reclaim的公共API。使用风险由您自行承担，并遵守Reclaim的服务条款。
社区维护 模型上下文协议 （MCP）服务器允许 _任何_ 支持MCP的客户端（Claude Desktop、Continue、Cursor、自定义脚本等）与 Reclaim.ai API 通过一套标准 资源 & 工具.
______________________________________________________________________
🧐 为什么选择MCP？
- MCP是LLM集成的“USB‑C”——一条让每个模型与每个工具通信的线。
- 运行此服务器一次，然后 _全部_ 您的MCP感知应用程序立即获得Reclaim超能力。
______________________________________________________________________
✨ 主要特点
- 活动任务资源 (
tasks://active)
- 14个任务操作工具 （列表、创建、更新、完成、计时器等）
- 🛡 类型安全（TypeScript+Zod）和可靠的错误处理
- 📦 零配置stdio传输——非常适合本地AI助手
______________________________________________________________________
📚 MCP能力
工具（动作）
| 工具 | 说明 | 参数 | ✅ 识别。 | ☠️ 德斯特。 | |
|---|---|---|---|---|---|
reclaim_list_tasks | 列出任务（默认=活动） | `{ "filter"?: "active"\ | "all" }` | ✅ | ❌ |
reclaim_get_task | 获取任务 | { "taskId": number } | ✅ | ❌ | |
reclaim_create_task | 创建新任务 | { /* task properties */ } | ❌ | ❌ | |
reclaim_update_task | 更新任务属性 | { "taskId": number, /* updated properties */ } | ✅ | ❌ | |
reclaim_mark_complete | 标记完成 | { "taskId": number } | ✅ | ❌ | |
reclaim_mark_incomplete | 无存档/标记不完整 | { "taskId": number } | ✅ | ❌ | |
reclaim_delete_task | 永久删除 | { "taskId": number } | ✅ | ✅ | |
reclaim_add_time | 添加日程分钟数 | { "taskId": number, "minutes": number } | ❌ | ❌ | |
reclaim_start_timer | 启动计时器 | { "taskId": number } | ✅ | ❌ | |
reclaim_stop_timer | 停止计时器 | { "taskId": number } | ✅ | ❌ | |
reclaim_log_work | 记录工作时间 | { "taskId": number, "minutes": number, "end"?: string } | ❌ | ❌ | |
reclaim_clear_exceptions | 清除日程安排异常 | { "taskId": number } | ✅ | ❌ | |
reclaim_prioritize | 在规划者中优先考虑 | { "taskId": number } | ✅ | ❌ |
______________________________________________________________________
⚠️ 已知问题
COMPLETE ≠完成。 回收标记任务 COMPLETE 当它 _预定街区_ 即使您尚未完成工作，也会结束。当LLM使用该工具提取活动任务时，此服务器确实将这些任务作为活动任务包含在内（并提醒模型 COMPLETE 任务仍然处于活动状态）。然而，法学硕士（克劳德）有时会忽略 COMPLETE 当被要求执行“打开”或“活动”任务时。如果发生这种情况，您可能需要明确提示LLM“包含状态为“完成”的任务”。
🚀 快速开始
- 先决条件
- Node.js≥18 - 回收API密钥
- Claude桌面配置（最小）
{ “mcpServers”：{ “回收”：{ “命令”：“npx”， “args”：\[ “回收mcp服务器” \], “env”：｛“RECLAIM_API_KEY”：“xxx”｝ } } }
**Alternative Configuration:**
{ "mcpServers": { "reclaim": { "command": "absolute/path/to/node (run which node in terminal)", "args": [ "/absolute/path/to/reclaim-mcp-server/dist/index.js" ], "env": { "RECLAIM_API_KEY": "xxx" } } } }
### 替代方案：手动安装
如果您更喜欢从源代码安装：
git clone https://github.com/jj3ny/reclaim-mcp-server.git cd reclaim-mcp-server pnpm install && pnpm build
Run with your API key
RECLAIM_API_KEY=your_api_key node dist/index.js
## 🤝 贡献
欢迎提交Bug报告和PR！贡献：
1. 分叉存储库
1. 创建要素分支(`git checkout -b feature/amazing-feature`)
1. 进行更改（遵循代码样式）
1. 使用常规提交进行提交(`feat:`, `fix:`等等）
1. 推到您的分支(`git push origin feature/amazing-feature`)
1. 打开拉取请求
请在打开PR之前压缩您的提交。
## 📄 许可证
麻省理工学院——见许可证。