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）及稳健的错误处理

• 📦 零配置标准 I/O 传输——非常适合本地 AI 助手

---

📚 MCP 能力

工具（动作）

工具	描述	参数	✅幂等性	☠️破坏性
reclaim_list_tasks	列出任务（默认为活动）	`{ "filter"?: "active"	"all" }`	✅
reclaim_get_task	获取任务	{ "taskId": number }	✅	❌
reclaim_create_task	创建新任务	{ /* 任务属性 */ }	❌	❌
reclaim_update_task	更新任务属性	{ "taskId": number, /* 更新的属性 */ }	✅	❌
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 ≠ 完成。 当任务的 预定块 结束时，即使你还没有完成工作，Reclaim 也会将任务标记为 COMPLETE。此服务器在 LLM 使用工具拉取活动任务时会包含这些任务（并提醒模型 COMPLETE 任务仍然处于活动状态）。然而，LLMs（如 Claude）有时会在请求“开放”或“活动”任务时忽略 COMPLETE 任务。如果发生这种情况，你可能需要明确提示 LLM “包括状态为 COMPLETE 的任务”。

🚀 快速开始

1. 前提条件

   • Node.js ≥ 18
   • Reclaim API 密钥

2. Claude Desktop 配置（最小配置）

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

**替代配置：**

```json
{
"mcpServers": {
 "reclaim": {
   "command": "绝对路径到 node (在终端运行 `which node`)",
   "args": [
     "/绝对路径到/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

# 使用你的 API 密钥运行
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. 打开一个 Pull Request

请在打开 PR 之前合并你的提交。

📄 许可证

MIT – 查看 LICENSE。