线性 MCP 集成服务器

该服务器通过模型上下文协议 (MCP) 提供 Linear 集成功能。它允许 AI 模型与 Linear 进行交互，以进行问题跟踪和项目管理。

特征

服务器通过MCP接口提供以下工具：

linear_create_issue

使用以下参数创建一个新的线性问题：

• title （必填）：问题标题
• teamId （必填）：创建问题的团队 ID
• description （可选）：问题描述（支持 markdown）
• priority （可选）：优先级（0-4）
• status （可选）：初始状态名称

线性搜索问题

通过灵活过滤来搜索线性问题：

• query （可选）：标题/描述中要搜索的文本
• teamId （可选）：按团队过滤
• status （可选）：按状态过滤
• assigneeId （可选）：按受让人过滤
• priority （可选）：优先级（0-4）
• limit （可选，默认值：10）：返回的最大结果

linear_sprint_issues

获取当前冲刺/迭代中的所有问题：

• teamId （必填）：获取冲刺问题的团队 ID

线性搜索团队

搜索并检索线性团队：

• query （可选）：在团队名称中搜索的文本

linear_filter_sprint_issues

按状态过滤当前冲刺问题并自动过滤到当前用户：

• teamId （必填）：获取冲刺问题的团队 ID
• status （必填）：要过滤的状态（例如“待发布产品”）

linear_bulk_update_status

一次更新多个线性问题的状态：

• issueIds （必需）：要更新的问题 ID 列表（例如 [“ENG-123”、“DATA-456”]）
• targetStatus （必需）：为所有问题设置的目标状态（例如“进行中”）

开发人员设置

1. 从 Linear 的设置 > API 部分获取 Linear API 密钥
2. 在项目根目录中创建一个.env文件：

3. 安装依赖项：

4. 启动服务器：

技术细节

• 使用 TypeScript 和模型上下文协议 SDK 构建
• 使用 Linear SDK 进行 API 交互
• 包括错误处理、速率限制和连接管理
• 支持自动重新连接并可配置重试次数
• 实施心跳监控以监测连接健康状况
• 在调试模式下提供详细日志记录

错误处理

该服务器包括全面的错误处理：

• API超时保护
• 连接丢失时自动重新尝试连接
• 带有时间戳的详细错误日志
• 优雅关机处理
• 连接健康状况的心跳监控

依赖项

• @linear/sdk ：线性 API 客户端
• @modelcontextprotocol/sdk ：MCP 服务器实现
• zod ：运行时类型检查和验证
• dotenv ：环境变量管理
• TypeScript 和相关开发工具

有关依赖项的完整列表，请参阅package.json 。