基本能力
产品定位
Linear MCP Server 是一个专门用于与 Linear 平台 API 交互的 MCP 服务,旨在通过编程方式自动化管理 Linear 平台上的问题、项目和团队。
核心功能
- 问题管理
- 创建新问题(可自定义标题、描述、团队、分配人、优先级和标签)
- 列出问题(支持按团队、分配人和状态过滤)
-
更新现有问题(标题、描述、状态、分配人、优先级)
-
团队管理
- 列出工作区中的所有团队
-
获取团队详细信息(包括 ID、名称、键和描述)
-
项目管理
- 列出所有项目(支持按团队过滤)
- 查看项目详细信息(包括名称、描述、状态和关联团队)
适用场景
- 自动化管理 Linear 平台上的问题和项目
- 集成 AI 代理与 Linear 平台进行交互
- 开发需要与 Linear API 交互的应用程序
工具列表
- create_issue: 创建新问题
- list_issues: 列出问题(支持过滤)
- update_issue: 更新现有问题
- list_teams: 列出所有团队
- list_projects: 列出所有项目(支持过滤)
- get_issue: 获取特定问题的详细信息
常见问题解答
- 错误处理包括无效 API 密钥、缺少必需参数、Linear API 错误和无效工具请求
- 所有错误都经过格式化并返回描述性消息
使用教程
使用依赖
- Node.js (v16 或更高版本)
- 具有 API 访问权限的 Linear 账户
- 具有适当权限的 Linear API 密钥
安装教程
- 从 Linear's Developer Settings 获取你的 Linear API 密钥
- 使用 API 密钥运行:
bash
LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp
或设置环境变量:
bash
export LINEAR_API_KEY=your-api-key
npx @ibraheem4/linear-mcp
调试方式
- 安装 supergateway:
bash
npm install -g supergateway - 使用包含的
run.sh
脚本:
bash
chmod +x run.sh
LINEAR_API_KEY=your-api-key ./run.sh - 访问 Inspector:
- 在浏览器中打开 localhost:1337
- Inspector 通过 Server-Sent Events (SSE) 连接
- 通过 Inspector 界面测试和调试工具调用