MCP Linear App

基本能力

产品定位

MCP Linear App 是一个 AI 与项目管理工具 Linear 的集成工具，通过 MCP 协议实现 AI 与 Linear 的无缝交互。

核心功能

• Complete Linear Integration:
• 搜索问题（search_issues）
• 创建新问题（create_issue）
• 更新问题（update_issue）
• 添加评论（create_comment）
• 更新评论（update_comment）
• 获取用户信息（get_profile）
• 获取团队信息（get_team_id）

适用场景

• AI 辅助项目管理
• 自动化问题跟踪和更新
• 团队协作中的问题管理

工具列表

• search_issues: 通过关键词、状态或优先级搜索问题
• create_issue: 创建新问题
• get_issue: 获取问题详情
• update_issue: 更新现有问题
• create_comment: 向问题添加评论
• get_comment: 获取问题的评论
• update_comment: 更新或删除评论
• get_profile: 获取当前 Linear 用户信息
• get_team_id: 获取团队列表及其 ID

常见问题解答

1. 如何获取 Linear API Key？
2. 登录 Linear 账户，进入 Workspace Settings > API，创建并保存 API Key。
3. 如何配置 Cursor？
4. 编辑 mcp.json 文件，添加 Linear MCP 服务器配置。
5. 如何配置 Claude？
6. 在 Claude 的 Developer 设置中添加 Linear MCP 配置。
7. 遇到问题怎么办？
8. 检查 API Key 是否有效，Node.js 是否安装正确，查看日志文件中的错误信息。

使用教程

使用依赖

• Node.js 18 或更新版本
• Linear API Key

安装教程

1. 克隆仓库：

git clone [email protected]:zalab-inc/mcp-linear-app.git
cd mcp-linear-app

1. 安装依赖：

npm install

1. 创建 .env 文件并添加 API Key：

LINEAR_API_KEY=your_linear_api_key_here

1. 构建项目：

npm run build

调试方式

1. 检查 dist 文件夹是否生成。
2. 验证 mcp.json 或 Claude 配置是否正确。
3. 重启 Cursor 或 Claude 使配置生效。
4. 尝试使用 AI 执行 Linear 相关操作，如搜索问题或创建新问题。

许可证

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