Karea MCP 是面向 Karea 任务管理的 MCP 服务器，目标是让 Claude Code、Cursor 以及其他兼容 MCP 的客户端在编写代码的同时直接管理开发任务。仓库标题提到 44 个工具，正文说明当前为 9 个工具、覆盖 70 个操作，这些元数据由 scripts/sync-metadata.mjs 重新生成。
用途 它把任务管理动作接入 AI 编码客户端，使开发者无需离开编辑器即可创建、编辑、关闭、回顾和关联开发任务，并围绕任务记录设计思路、调查笔记、待解决问题与相关资源。
主要能力
- 任务与子任务：创建、编辑、关闭、删除任务和子任务；支持批量编辑、批量关闭；记录已完成或进行中的工作；管理任务关闭前所需的检查清单（closing requisites）。
- 笔记与文档：为任务添加或编辑笔记、便签；读写任务的长篇 Markdown 文档；写入任务的 AI Context（跨会话的私有记忆）。编辑会覆盖被替换的内容。
- 待解决问题：按任务跟踪 open questions，并可稍后回答、编辑。
- 资源：创建、上传、更新文件/文档库中的资源，并将其附加到任务；支持文件引用与链接。
- Jira 关联：将任务链接到 Jira 问题，并支持反向关联与解除关联。
- 生产力回顾：按日期范围获取活动回顾（recap）。
- 项目与分类：创建项目、在项目内创建分类、通过邮箱与他人共享项目。
- 会议与提醒：创建和编辑会议，把任务或问题加入会议议程；创建、推迟、忽略或完成提醒。
- AI 助手：向 Karea AI 助手发送自然语言请求，助手可能读取或修改任务来执行该请求。
- 删除与解除关联：删除项目、分类、任务、检查项、笔记、便签、问题、资源、会议；解除资源、任务、问题、Jira 问题或 AI 会话的关联。部分永久删除需要 confirm=true。
使用方式 在 Claude Code 中，可添加到 ~/.claude.json，或运行 claude mcp add；API key 在 https://karea.app/dashboard/settings?section=api-keys 获取。在 Cursor 中，可添加到项目内的 .cursor/mcp.json，或全局的 ~/.cursor/mcp.json。
工具采用 action + params 的调用形式：动作不是独立工具，例如 karea_list_notes 通过 karea_read 调用，参数为 { "action": "karea_list_notes", "params": { ... } }，动作的 karea_ 前缀可省略。设置环境变量 KAREA_MCP_LEGACY_TOOLS=1 可恢复为将全部 70 个动作注册为独立工具的旧模式。
9 个工具及其覆盖的动作：
- karea_read：只读访问项目、任务、子任务、笔记、便签、任务文档与 AI 上下文、待解决问题、资源、会议、提醒、Jira 链接、AI 会话和活动回顾，是主要入口。包含 karea_list_projects、karea_list_tasks、karea_view_task、karea_view_tasks、karea_task_changes、karea_list_subtasks、karea_list_notes、karea_list_sticky_notes、karea_get_markdown、karea_get_context、karea_list_questions、karea_list_resources、karea_get_resource、karea_list_meetings、karea_view_meeting、karea_check_reminders、karea_get_jira_link、karea_list_sessions、karea_recap。
- karea_tasks_write：创建与变更任务，包含 karea_create_task、karea_quick_task、karea_doing、karea_edit_task、karea_edit_tasks、karea_close_task、karea_done、karea_create_subtask、karea_add_requisite、karea_toggle_requisite。
- karea_notes_write：写入笔记，包含 karea_add_note、karea_edit_note、karea_create_sticky_note、karea_edit_sticky_note、karea_set_markdown、karea_set_context。
- karea_projects_write：包含 karea_create_project、karea_create_category、karea_share_project。
- karea_meetings_write：包含 karea_create_meeting、karea_edit_meeting、karea_link_task_to_meeting、karea_link_question_to_meeting、karea_create_question、karea_answer_question、karea_edit_question、karea_create_reminder、karea_snooze_reminder、karea_dismiss_reminder、karea_mark_reminder_done。
- karea_resources_write：包含 karea_create_resource、karea_upload_resource、karea_update_resource、karea_link_resource_to_task、karea_link_jira、karea_link_session。
- karea_assistant：包含 karea_ask，发送自然语言请求给 Karea AI 助手。
- karea_delete：包含 karea_delete_project、karea_delete_category、karea_delete_task、karea_delete_requisite、karea_delete_note、karea_delete_sticky_note、karea_delete_question、karea_delete_resource、karea_delete_meeting、karea_unlink_resource_from_task、karea_unlink_task_from_meeting、karea_unlink_question_from_meeting、karea_unlink_jira、karea_unlink_session。
- karea_help：提供任意动作的完整参数 schema。
列表类动作至少需要一个过滤条件，单次调用不能导出全部数据；缺少过滤条件时调用会被拒绝并列出可接受的过滤条件，便于代理立即重试。karea_list_projects 不需要过滤条件（代理借此找到 projectId），karea_check_reminders 中的待处理提醒也不需要。
适用场景 适合在 Claude Code、Cursor 等 MCP 客户端中进行开发工作的用户，用于在编码过程中同步管理任务、记录设计思路与调查笔记、跟踪待解决问题、关联 Jira 与资源、生成生产力回顾。
限制 需要 Karea 账户与 API key；使用前需在客户端配置 MCP 服务器。列表动作必须提供过滤条件。部分永久删除需要 confirm=true。编辑笔记、Markdown 或 AI Context 会覆盖被替换的内容。仓库采用 MIT 许可，详见 LICENSE。