内容
# karea-mcp
Karea 的 MCP 服务器。 <!-- SYNC:TOOL_COUNT -->44<!-- /SYNC:TOOL_COUNT --> 个工具，允许 Claude Code、Cursor 和其他 MCP 兼容的客户端在您编码的同时创建、编辑、关闭、总结、链接和管理任务。
[](https://www.npmjs.com/package/karea-mcp)
[](https://github.com/starecz/karea-mcp/blob/main/LICENSE)
[](https://glama.ai/mcp/servers/starecz/karea-mcp)
## 功能
- 在 Claude Code 中创建/编辑/关闭/删除任务和子任务
- 在任何任务中读写长篇 Markdown（适合解决方案设计和调查笔记）
- 跟踪每个任务的未解决问题并稍后回答
- 附件资源（文件引用、链接）到任务
- 将任务链接到 Jira 并返回
- 获取指定日期范围的生产力总结
- 管理类别、项目和项目共享
## 安装
```bash
npx karea-mcp
```
## 配置（Claude Code）
添加到 `~/.claude.json`（或运行 `claude mcp add`）：
```json
{
"mcpServers": {
"karea": {
"command": "npx",
"args": ["-y", "karea-mcp"],
"env": {
"KAREA_API_KEY": "您的密钥",
"KAREA_URL": "https://karea.app"
}
}
}
}
```
在 <https://karea.app/dashboard/settings/api-keys> 获取您的 API 密钥。
## 配置（Cursor）
添加到 `.cursor/mcp.json`（在您的项目中）或 `~/.cursor/mcp.json`（全局）：
```json
{
"mcpServers": {
"karea": {
"command": "npx",
"args": ["-y", "karea-mcp"],
"env": {
"KAREA_API_KEY": "您的密钥"
}
}
}
}
```
## 工具目录
<!-- SYNC:TOOL_CATALOGUE -->
**44 个工具**（由 `scripts/sync-metadata.mjs` 生成）：
- `karea_add_note`
- `karea_add_requisite`
- `karea_answer_question`
- `karea_ask`
- `karea_close_task`
- `karea_create_category`
- `karea_create_project`
- `karea_create_question`
- `karea_create_resource`
- `karea_create_subtask`
- `karea_create_task`
- `karea_delete_category`
- `karea_delete_note`
- `karea_delete_project`
- `karea_delete_question`
- `karea_delete_requisite`
- `karea_delete_resource`
- `karea_delete_task`
- `karea_doing`
- `karea_done`
- `karea_edit_note`
- `karea_edit_question`
- `karea_edit_task`
- `karea_get_jira_link`
- `karea_get_markdown`
- `karea_get_resource`
- `karea_link_jira`
- `karea_link_resource_to_task`
- `karea_list_notes`
- `karea_list_projects`
- `karea_list_questions`
- `karea_list_resources`
- `karea_list_subtasks`
- `karea_list_tasks`
- `karea_quick_task`
- `karea_recap`
- `karea_set_markdown`
- `karea_share_project`
- `karea_toggle_requisite`
- `karea_unlink_jira`
- `karea_unlink_resource_from_task`
- `karea_update_resource`
- `karea_upload_resource`
- `karea_view_task`
<!-- /SYNC:TOOL_CATALOGUE -->
## 工作流程示例
```
您：我正在处理身份验证错误。
Claude（通过 karea-mcp）：karea_doing("身份验证错误")
--> 状态设置为进行中
您：添加一个关闭必需的项：必须通过失败的测试。
Claude：karea_add_requisite(...)
您（稍后）：我已修复。
Claude：karea_toggle_requisite(...) 然后 karea_done("身份验证错误")
```
## 许可证
MIT。查看 [LICENSE](https://github.com/starecz/karea-mcp/blob/main/LICENSE)。
