使用说明
kaneo mcp
MCP(模型上下文协议)服务器 Kaneo --一个自托管的看板项目管理工具。使AI助手能够通过自然语言管理您的项目和任务。
特性
- 项目 --列出、创建、更新、删除项目
- 任务 --完全CRUD、列间移动、导出、过滤和排序
- 列 --查看和创建看板栏
- 评论 --阅读任务并添加评论
- 标签 --列出、附着和分离标签
- 搜索 --跨任务、项目等进行全局搜索
- 工作区 --列出工作区成员
- HTTP远程服务器 --在您的VPS上与Kaneo一起部署
设置
1.获取API密钥
- 登录您的Kaneo实例
- 首选 设置→ 账户→ 开发人员设置
- 点击 创建API密钥 并立即复制
2.查找您的工作区ID
通过API列出您的工作空间或在Kaneo URL中找到它。
部署
与Kaneo一起部署在您的服务器上。团队成员只需配置一个URL,不需要Node.js或安装。
使用Docker进行部署
git clone https://github.com/Sol1de/kaneo-mcp.git
cd kaneo-mcp
编辑 docker-compose.yml 根据您的设置,然后:
docker compose up -d
环境变量(服务器端)
| 变量 | 必填 | 描述 |
|---|---|---|
KANEO_URL |
是 | Kaneo实例的URL |
KANEO_WORKSPACE_ID |
是 | 默认工作区ID |
MCP_PORT |
无 | HTTP端口(默认值:3000) |
用户配置--克劳德桌面
每个团队成员都将此添加到他们的 claude_desktop_config.json:
{
"mcpServers": {
"kaneo": {
"url": "https://mcp.your-domain.com/mcp",
"headers": {
"Authorization": "Bearer your-personal-kaneo-api-key"
}
}
}
}
每个用户都提供自己的Kaneo API密钥作为Bearer令牌。在中创建一个 Kaneo→ 设置→ 账户→ 开发人员设置.
或者,令牌可以作为查询参数传递:
https://mcp.your-domain.com/mcp?token=your-personal-kaneo-api-key
有关完整文档,请参阅 docs/ 文件夹。
可用工具
| 工具 | 说明 |
|---|---|
list-projects |
列出工作区中的所有项目 |
get-project |
获取项目详细信息 |
create-project |
创建新项目 |
update-project |
更新项目详细信息 |
delete-project |
删除项目 |
list-tasks |
使用筛选器和排序列出任务 |
get-task |
获取任务详细信息 |
create-task |
创建新任务 |
update-task |
更新所有任务字段 |
move-task |
将任务移动到其他列 |
delete-task |
删除任务 |
export-tasks |
导出项目中的所有任务 |
list-columns |
列出看板栏 |
create-column |
创建新列 |
get-task-comments |
获取任务注释和活动 |
create-comment |
向任务添加注释 |
list-labels |
列出工作区标签 |
get-task-labels |
为任务添加标签 |
attach-label |
为任务附加标签 |
detach-label |
从任务中删除标签 |
search |
搜索所有Kaneo数据 |
list-workspace-members |
列出工作区成员 |
构建二进制文件
要构建一个独立的二进制文件(不需要运行Node.js):
npm run build
npm run build:binary
二进制文件将在 build/kaneo-mcp-<os>-<arch>.
许可证
麻省理工学院
