看板管理服务

一个轻量级的MCP服务器,通过Linear API提供看板管理功能,适用于团队协作和项目管理。

  • by 0xikarus
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 0xikarus/linear-kanban-mcp

使用说明

线性看板服务器

一个轻量级的MCP服务器,公开了用于看板管理的线性API,专为与Claude Desktop和Claude Code集成而设计。

快速设置

claude mcp add linear-kanban -- bun run /path/to/linear-kanban-server/src/mcp-server.ts -e LINEAR_API_KEY=lin_api_YOUR_KEY

手动设置

  1. 安装依赖项:
bun install
  1. 添加到您的克劳德代码设置(~/.claude/settings.json):
{
  "mcpServers": {
    "linear-kanban": {
      "command": "bun",
      "args": ["run", "/path/to/linear-kanban-server/src/mcp-server.ts"],
      "env": {
        "LINEAR_API_KEY": "lin_api_YOUR_API_KEY_HERE"
      }
    }
  }
}
  1. 在Claude中使用:
  • “向我展示工程团队中的所有问题”
  • “为登录问题创建新的错误报告”
  • “将问题ENG-123移至进行中”

可用工具

团队和用户管理

  • list_teams -让所有团队进入工作区
  • list_users -获取工作区中的所有用户

项目运营

  • list_projects -列出所有项目
  • get_project -获取详细的项目信息(状态、潜在客户、最近更新)
  • list_project_updates -查看项目更新历史记录
  • create_project_update -发布健康状态的进度更新(onTrack/atRisk/offTrack)

问题管理

  • list_issues -列出问题(可选择按项目筛选)
  • get_issue -获取完整上下文的详细问题(包括里程碑信息)
  • create_issue -创建新问题(支持里程碑分配)
  • update_issue -更新问题属性(支持里程碑分配)
  • move_issue -将问题转移到不同的工作流状态
  • add_comment -为问题添加评论
  • search_issues -全文搜索

工作流配置

  • list_workflow_states -为团队获取看板栏(带位置和颜色)

里程碑管理

  • list_milestones -列出所有里程碑,可选择按项目筛选
  • get_milestone -获取详细的里程碑信息,包括分配的问题
  • create_milestone -为项目创建新的里程碑
  • update_milestone -更新里程碑属性(名称、描述、目标日期)
  • delete_milestone -删除里程碑
  • assign_issue_to_milestone -将问题分配给里程碑或从当前里程碑中删除
  • list_milestone_issues -列出分配给特定里程碑的所有问题

资源

服务器提供以下MCP资源:

  • linear://teams -JSON中的所有团队
  • linear://projects -所有项目均为JSON格式
  • linear://issues -最近几期(前50期)
  • linear://workflow-states -可用看板栏
  • linear://project-updates -跨工作区的最新项目更新
  • linear://milestones -项目中的所有里程碑

提示

常见任务的指导工作流程:

  • kanban_overview -生成按列组织的看板概览
  • create_task -引导任务创建,自动选择团队和状态
  • daily_standup -生成已完成/正在进行/已阻止项目的站立摘要
  • write_project_update -指导项目更新与健康状况的写作
  • milestone_overview -获取项目的里程碑进度概述

示例用法

问题管理

"Show me all issues in the Engineering team"
"Create a new bug report titled 'Login button broken'"
"Move issue ENG-123 to In Progress"
"Search for issues about authentication"

里程碑管理

"List all milestones for project X"
"Create a milestone called 'v1.0 Release' for project X with target date 2024-06-01"
"Show me all issues in the 'Q1 Goals' milestone"
"Assign issue ENG-456 to the 'v1.0 Release' milestone"
"Update milestone to change target date to 2024-07-01"
"What's the progress on each milestone in project X?"

项目更新

"Write a project update for project X"
"Show me recent updates for the Mobile App project"

看板

"Show me the kanban board overview"
"What's the daily standup summary?"