Linear MCP Server

基本能力

产品定位

Linear MCP Server 是一个专为与 Linear 平台 API 交互设计的 MCP 服务，旨在通过编程方式管理问题、项目和团队。

核心功能

• 问题管理
• 创建新问题（支持自定义标题、描述、团队、分配人、优先级和标签）
• 列出问题（支持团队、分配人、状态等过滤选项）

• 更新现有问题（支持修改标题、描述、状态、分配人、优先级等）

• 团队管理

• 列出工作空间中的所有团队

• 获取团队详细信息（包括 ID、名称、键和描述）

• 项目管理

• 列出所有项目（支持团队过滤）
• 查看项目详细信息（包括名称、描述、状态和关联团队）

适用场景

• AI 代理需要自动化管理 Linear 平台上的问题和项目
• 开发团队需要集成 Linear 的问题跟踪功能到其他系统中
• 需要批量操作或自动化处理 Linear 中的任务

工具列表

• create_issue: 创建新问题
• list_issues: 列出问题（支持过滤）
• update_issue: 更新现有问题
• list_teams: 列出所有团队
• list_projects: 列出所有项目（支持过滤）
• get_issue: 获取特定问题的详细信息

常见问题解答

• 错误处理包括无效 API 密钥、缺少必需参数、Linear API 错误和无效工具请求
• 所有错误都经过格式化并返回描述性消息

使用教程

使用依赖

• Node.js (v16 或更高版本)
• 具有 API 访问权限的 Linear 账户
• 具有适当权限的 Linear API 密钥

安装教程

1. 从 Linear 开发者设置 获取 API 密钥
2. 使用 API 密钥运行:

LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

或设置环境变量:

export LINEAR_API_KEY=your-api-key
npx @ibraheem4/linear-mcp

开发设置

1. 克隆仓库:

git clone [repository-url]
cd linear-mcp

1. 安装依赖:

npm install

1. 构建项目:

npm run build

调试方式

1. 安装 supergateway:

npm install -g supergateway

1. 使用 run.sh 脚本:

chmod +x run.sh
LINEAR_API_KEY=your-api-key ./run.sh

1. 访问 Inspector:
2. 在浏览器中打开 localhost:1337
3. Inspector 通过 Server-Sent Events (SSE) 连接
4. 通过 Inspector 界面测试和调试工具调用

对于自动重建的开发模式:

npm run watch

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。