JinDaGe - reclaim-mcp-server MCP Details

article

README

🚀 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。

reclaim-mcp-server