使用说明
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“包含状态为“完成”的任务”。
🚀 快速开始
-
先决条件
- Node.js≥18
- 回收API密钥
-
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!贡献:
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 进行更改(遵循代码样式)
- 使用常规提交进行提交(
feat:,fix:等等) - 推到您的分支(
git push origin feature/amazing-feature) - 打开拉取请求
请在打开PR之前压缩您的提交。
📄 许可证
麻省理工学院——见许可证。
