Reclaim MCP服务器

一个由社区维护的模型上下文协议(MCP)服务器,允许任何支持MCP的客户端通过Reclaim.ai API与任务管理功能交互。

  • by johnjhughes
  • TypeScript
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 jj3ny/reclaim-mcp-server

使用说明

Reclaim.ai MCP服务器🚀 (非官方)

⚠️ 非官方&无关联 这个项目是 不 Reclaim.ai认可、赞助或支持。它只使用Reclaim的公共API。使用风险由您自行承担,并遵守Reclaim的服务条款。

官方备选方案: Reclaim.ai提供官方远程MCP服务器 https://mcp.reclaim.ai。与此社区服务器相比,您可能更喜欢第一方集成。看 Reclaim的设置说明 和 #3.

社区维护 模型上下文协议 (MCP)服务器允许 任何 支持MCP的客户端(Claude Desktop、Continue、Cursor、自定义脚本等)与 Reclaim.ai API 通过一套标准 资源 & 工具.


🧐 为什么选择MCP?

  • MCP是LLM集成的“USB‑C”——一条让每个模型与每个工具通信的线。

  • 运行此服务器一次,然后 全部 您的MCP感知应用程序立即获得Reclaim超能力。


✨ 主要特点

  • 活动任务资源 (tasks://active)

  • 13个任务操作工具 (列表、创建、更新、完成、计时器等)

  • 🛡 类型安全(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“包含状态为“完成”的任务”。

🚀 快速开始

  1. 先决条件

  2. Claude桌面配置(最小)

    {
      "mcpServers": {
        "reclaim": {
          "command": "npx",
          "args": ["reclaim-mcp-server"],
          "env": { "RECLAIM_API_KEY": "xxx" }
        }
      }
    }
    

替代配置:

{
  "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. 分叉存储库
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 进行更改(遵循代码样式)
  4. 使用常规提交进行提交(feat:, fix:等等)
  5. 推到您的分支(git push origin feature/amazing-feature)
  6. 打开拉取请求

请在打开PR之前压缩您的提交。

📄 许可证

麻省理工学院——见许可证。