Linear MCP 集成服务器

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

功能

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

linear_create_issue

创建一个新的 Linear issue，具有以下参数：

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

linear_search_issues

搜索 Linear issue，具有灵活的过滤功能：

• query (可选): 在标题/描述中搜索的文本
• teamId (可选): 按团队过滤
• status (可选): 按状态过滤
• assigneeId (可选): 按受让人过滤
• priority (可选): 优先级 (0-4)
• limit (可选, 默认: 10): 返回的最大结果数

linear_sprint_issues

获取当前 sprint/迭代中的所有 issue：

• teamId (必需): 获取 sprint issue 的团队 ID

linear_search_teams

搜索和检索 Linear 团队：

• query (可选): 在团队名称中搜索的文本

linear_filter_sprint_issues

按状态过滤当前 sprint issue，并自动过滤到当前用户：

• teamId (必需): 获取 sprint issue 的团队 ID
• status (必需): 要过滤的状态（例如 "Pending Prod Release"）

linear_bulk_update_status

一次更新多个 Linear issue 的状态：

• issueIds (必需): 要更新的 issue ID 列表（例如 ["ENG-123", "DATA-456"]）
• targetStatus (必需): 要为所有 issue 设置的目标状态（例如 "In Progress"）

开发者设置

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

LINEAR_API_KEY=your_api_key_here

3. 安装依赖项：

npm install

4. 启动服务器：

# 具有自动重新加载的开发模式
npm run dev

# 生产模式
npm start

# 构建 TypeScript
npm run build

# 运行 linter
npm run lint

# 运行测试
npm run test

# 检查 MCP 服务器
npm run inspect

技术细节

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

错误处理

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

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

依赖项

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

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