Linear MCP Server

重要说明： 此 MCP 服务器现已弃用且不再维护。建议您使用官方的 Linear 远程 MCP 服务器：https://linear.app/changelog/2025-05-01-mcp (https://mcp.linear.app/sse)

这是一个用于 Linear API 的 Model Context Protocol 服务器。

此服务器通过 MCP 提供与 Linear 问题跟踪系统集成的功能，允许 LLM 与 Linear 问题进行交互。

安装

自动安装

要通过 Smithery 自动安装 Linear MCP 服务器：

npx @smithery/cli install linear-mcp-server --client claude

手动安装

1. 创建或获取您的团队的 Linear API 密钥：https://linear.app/YOUR-TEAM/settings/api

2. 在 Claude Desktop 中添加服务器配置：

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

组件

工具

1. linear_create_issue: 创建新的 Linear 问题

   • 必需输入：
     • title (字符串)：问题标题
     • teamId (字符串)：创建问题的团队 ID
   • 可选输入：
     • description (字符串)：问题描述（支持 Markdown）
     • priority (数字，范围 0-4)：优先级级别（1=紧急，4=低）
     • status (字符串)：初始状态名称

2. linear_update_issue: 更新现有问题

   • 必需输入：
     • id (字符串)：要更新的问题 ID
   • 可选输入：
     • title (字符串)：新标题
     • description (字符串)：新描述
     • priority (数字，范围 0-4)：新优先级
     • status (字符串)：新状态名称

3. linear_search_issues: 使用灵活过滤搜索问题

   • 可选输入：
     • query (字符串)：在标题/描述中搜索的文本
     • teamId (字符串)：按团队筛选
     • status (字符串)：按状态筛选
     • assigneeId (字符串)：按分配人筛选
     • labels (字符串数组)：按标签筛选
     • priority (数字)：按优先级筛选
     • limit (数字，默认值：10)：最大结果数

4. linear_get_user_issues: 获取分配给用户的任务

   • 可选输入：
     • userId (字符串)：用户 ID（省略以查看已认证用户）
     • includeArchived (布尔值)：是否包含已存档的任务
     • limit (数字，默认值：50)：最大结果数

5. linear_add_comment: 向问题添加评论

   • 必需输入：
     • issueId (字符串)：要评论的问题 ID
     • body (字符串)：评论内容（支持 Markdown）
   • 可选输入：
     • createAsUser (字符串)：自定义用户名
     • displayIconUrl (字符串)：自定义头像 URL

资源

• linear-issue:///{issueId} - 查看单个问题详情
• linear-team:///{teamId}/issues - 查看团队问题
• linear-user:///{userId}/assigned - 查看用户分配的任务
• linear-organization: - 查看组织信息
• linear-viewer: - 查看当前用户上下文

使用示例

一些可以与 Claude Desktop 一起使用的示例提示，以与 Linear 进行交互：

1. "显示我所有高优先级的问题" → 执行 search_issues 工具和/或 linear-user:///{userId}/assigned 查找分配给您的优先级为 1 的问题

2. "根据我已经告诉你的关于这个错误的信息，为身份验证系统创建一个错误报告" → 使用 create_issue 创建一个新的高优先级问题，并附上适当的详细信息和状态跟踪

3. "查找所有正在进行的前端任务" → 使用 search_issues 查找与前端相关的正在进行的任务

4. "给我最近关于移动应用开发问题的更新摘要" → 使用 search_issues 确定相关问题，然后使用 linear-issue:///{issueId} 获取问题详情并展示最近的活动和评论

5. "移动团队目前的工作量是多少？" → 结合 linear-team:///{teamId}/issues 和 search_issues 分析移动团队的问题分布和优先级

开发

1. 安装依赖项：

npm install

1. 在 .env 中配置 Linear API 密钥：

LINEAR_API_KEY=your_api_key_here

1. 构建服务器：

npm run build

对于开发时自动重建：

npm run watch

许可证

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由地使用、修改和分发该软件，但须遵守 MIT 许可证中的条款和条件。更多详情，请参见项目存储库中的 LICENSE 文件。