{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_fh7s89rmamuc","handle":"todo-mcp-server","url":"https://wellknown.network/agents/todo-mcp-server","links":{"self":"https://wellknown.network/agents/todo-mcp-server/record.json","html":"https://wellknown.network/agents/todo-mcp-server","markdown":"https://wellknown.network/agents/todo-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/todo-mcp-server","status":"https://wellknown.network/api/v1/agents/todo-mcp-server/status","claim":"https://wellknown.network/agents/todo-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/todo-mcp-server/claim.json","badge":"https://wellknown.network/agents/todo-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:todo-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"todo-mcp-server","summary":"Todo MCP Server powered by FastMCP - 支持多用户的待办事项管理MCP服务器，与 todo-api 同步更新","description":"# Todo MCP Server\n\n一个用于Cursor集成的Todo任务管理MCP服务器，支持多用户配置。\n\n## ✨ 功能特性\n\n- 🔧 **12个MCP工具**: 完整的任务和项目管理功能\n- 📊 **3个资源**: 任务统计、最近任务、逾期任务\n- 💬 **2个提示**: 任务摘要、优化建议\n- 🔐 **多种认证**: 支持Token和用户名密码认证\n- 🌐 **多服务器**: 支持连接不同的Todo API服务器\n- 🔄 **同步更新**: 与 todo-api 完全同步，支持项目和任务管理\n\n## 📦 安装\n\n通过PyPI安装：\n\n```bash\npip install todo-mcp-server\n```\n\n或使用uvx（推荐）：\n\n```bash\nuvx todo-mcp-server --help\n```\n\n## 🚀 使用方法\n\n### Cursor配置\n\n在 `~/.cursor/mcp.json` 中添加配置：\n\n#### 使用API Token认证\n```json\n{\n  \"mcpServers\": {\n    \"my-todo\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"todo-mcp-server\",\n        \"--api-url=https://your-todo-server.com:3000\",\n        \"--api-token=your-secret-token\"\n      ]\n    }\n  }\n}\n```\n\n#### 使用用户名密码认证\n```json\n{\n  \"mcpServers\": {\n    \"my-todo\": {\n      \"command\": \"uvx\", \n      \"args\": [\n        \"todo-mcp-server\",\n        \"--api-url=https://your-todo-server.com:3000\",\n        \"--username=your-username\",\n        \"--password=your-password\"\n      ]\n    }\n  }\n}\n```\n\n### 命令行参数\n\n| 参数 | 必需 | 描述 | 示例 |\n|------|------|------|------|\n| `--api-url` | ✅ | Todo API服务器地址 | `https://api.example.com:3000` |\n| `--api-token` | 🔄 | API访问令牌 | `abc123...` |\n| `--username` | 🔄 | 用户名 | `john.doe` |\n| `--password` | 🔄 | 密码 | `secret123` |\n| `--timeout` | ❌ | 请求超时时间（默认30秒） | `60` |\n\n注：`--api-token` 或 `--username + --password` 必须提供其中一种。\n\n## 🛠️ 可用工具\n\n### 任务管理\n- **创建任务**: \"帮我创建一个任务：完成项目文档\"\n- **查看任务**: \"显示我的待办任务列表\"\n- **更新任务**: \"将任务1标记为已完成\"\n- **删除任务**: \"删除任务1\"\n- **搜索任务**: \"搜索包含'项目'的任务\"\n- **获取任务详情**: \"显示任务1的详细信息\"\n\n### 项目管理\n- **创建项目**: \"创建一个新项目：网站重构\"\n- **查看项目**: \"显示我的项目列表\"\n- **更新项目**: \"将项目1状态改为已完成\"\n- **删除项目**: \"删除项目1\"\n- **获取项目详情**: \"显示项目1的详细信息\"\n- **查看项目任务**: \"显示项目1下的所有任务\"\n\n### 资源访问\n- **获取统计**: \"显示我的任务统计信息\"\n- **查看逾期**: \"显示所有逾期的任务\"\n\n## 🔄 同步更新\n\n### v1.1.0 更新内容\n\n- ✅ **API路径同步**: 更新为与 todo-api 一致的路径格式\n- ✅ **数据结构适配**: 支持 todo-api 的数字优先级和分页机制\n- ✅ **项目管理**: 新增完整的项目 CRUD 操作\n- ✅ **任务关联**: 支持任务与项目的关联管理\n- ✅ **错误处理**: 优化错误处理和状态码检查\n\n### 兼容性\n\n- 与 todo-api v1.0+ 完全兼容\n- 支持 PostgreSQL 和 SQLite 数据库\n- 保持向后兼容性\n\n## 🔧 开发\n\n###…","publisher":null,"homepage":"https://github.com/huangzhenxin/todo-mcp-server#readme","repository":"https://github.com/huangzhenxin/todo-mcp-server#readme","version":"2.1.4","license":"MIT","protocols":["mcp"],"tags":["ai","cursor","mcp","model-context-protocol","todo"],"pricing":null,"endpoints":[{"url":"pypi:todo-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.tasks","name":"Tasks & To-do","confidence":1,"provenance":"declared"},{"slug":"data.database","name":"Databases","confidence":0.825,"provenance":"derived"}],"categories":["data","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"todo-mcp-server","registry":"pypi","observedAt":"2026-09-10T14:24:28.203Z","publishedAt":"2025-08-12T11:38:17.762925Z","latestVersion":"2.1.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"todo-mcp-server","url":"https://pypi.org/project/todo-mcp-server/","firstSeenAt":"2026-09-10T14:22:46.982Z","fetchedAt":"2026-09-10T14:22:46.982Z","normalizedAt":"2026-09-10T14:22:46.982Z"}]},"firstSeenAt":"2026-09-10T14:22:46.982Z","updatedAt":"2026-09-10T14:24:28.203Z"}