🚀 Reclaim.ai MCP 服务器 🚀 (非官方)
这是一个由社区维护的 模型上下文协议 (MCP) 服务器，借助它，任何 MCP 兼容客户端（如 Claude Desktop、Continue、Cursor、自定义脚本等）都能通过一组标准的 资源 和 工具 与 Reclaim.ai API 进行交互。
⚠️ 重要提示
此项目未得到 Reclaim.ai 的认可、赞助或支持，它仅使用了 Reclaim 的公共 API。请自行承担风险并遵守 Reclaim 的服务条款。
🚀 快速开始
方案一：通过 npm 包运行
安装并运行 MCP 服务器：
npm install reclaim-mcp-server --save-dev
然后在您的配置文件中添加以下内容：
{
"mcpServers": {
"reclaim": {
"command": "npx",
"args": [
"reclaim-mcp-server"
],
"env": { "RECLAIM_API_KEY": "your_api_key_here" }
}
}
}
方案二：手动安装
如果需要从源码安装：
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
✨ 主要特性
- 活跃任务资源（
tasks://active） - 14 个任务操作工具（列出、创建、更新、完成、计时器等）
- 🛡 类型安全（TypeScript + Zod）和稳固的错误处理
- 📦 零配置 stdio 运输——非常适合本地 AI 助手
🧐 为什么选择 MCP？
- MCP 是 LLM 集成的“USB - C”——一根线即可让每个模型与每个工具通信。
- 运行此服务器一次，所有您的 MCP 感知应用程序立即获得 Reclaim 的超强功能。
📚 详细文档
工具（操作）
| 工具 | 描述 | 参数 | ✅ 幂等性 | ☠️ 破坏性 |
|---|---|---|---|---|
reclaim_list_tasks |
列出任务 (默认为活跃) | { "filter"?: "active"|"all" } |
✅ | ❌ |
reclaim_get_task |
获取任务 | { "taskId": number } |
✅ | ❌ |
reclaim_create_task |
创建新任务 | { /* 任务属性 */ } |
❌ | ❌ |
reclaim_update_task |
更新任务 | { /* 要更新的属性 */ } |
✅ | ❌ |
reclaim_delete_task |
删除任务 | { "taskId": number } |
✅ | ⚠️ |
reclaim_add_task |
添加任务到列表 | { "taskId": number, "listId": string } |
✅ | ❌ |
reclaim_remove_task |
从列表移除任务 | { "taskId": number, "listId": string } |
✅ | ⚠️ |
reclaim_complete_task |
完成任务 | { "taskId": number } |
✅ | ⚠️ |
reclaim_uncomplete_task |
取消完成任务 | { "taskId": number } |
✅ | ⚠️ |
reclaim_due_date_task |
设置截止日期 | { "taskId": number, "dueDate": string } |
✅ | ⚠️ |
reclaim_clear_duedate_task |
清除截止日期 | { "taskId": number } |
✅ | ⚠️ |
reclaim_priority_task |
设置优先级 | { "taskId": number, "priority": number } |
✅ | ⚠️ |
reclaim_clear_priority_task |
移除优先级 | { "taskId": number } |
✅ | ⚠️ |
reclaim_notes_task |
添加备注 | { "taskId": number, "notes": string } |
✅ | ⚠️ |
reclaim_clear_notes_task |
清除备注 | { "taskId": number } |
✅ | ⚠️ |
🚨 注意事项
⚠️ 重要提示
所有任务操作都需要有效的 Reclaim API 密钥。
💡 使用建议
建议在生产环境中使用环境变量存储 API 密钥，避免硬编码。
🤝 贡献
欢迎提交问题报告和拉取请求！贡献步骤如下：
- 叉取仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 进行更改（遵循代码风格）
- 使用约定提交（
feat:、fix:等） - 推送到您的分支 (
git push origin feature/amazing-feature) - 提交拉取请求
请在提交 PR 前将 commits 整合。
📄 许可证
MIT – 详见 LICENSE。