Linear MCP Server

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 的问题跟踪系统，让大模型能够与 Linear 问题交互。

安装

自动安装

通过 Smithery 为 Claude Desktop 自动安装 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（string）：问题标题
     • teamId（string）：要创建问题的团队 ID
   • 可选输入：
     • description（string）：问题描述（支持 Markdown）
     • priority（number, 0-4）：优先级（1=紧急，4=低）
     • status（string）：初始状态名称

2. linear_update_issue：更新现有问题

   • 必填输入：
     • id（string）：要更新的问题 ID
   • 可选输入：
     • title（string）：新标题
     • description（string）：新描述
     • priority（number, 0-4）：新优先级
     • status（string）：新状态名称

3. linear_search_issues：使用灵活的筛选条件搜索问题

   • 可选输入：
     • query（string）：在标题/描述中搜索的文本
     • teamId（string）：按团队筛选
     • status（string）：按状态筛选
     • assigneeId（string）：按受指派人筛选
     • labels（string[]）：按标签筛选
     • priority（number）：按优先级筛选
     • limit（number, default: 10）：最大结果数

4. linear_get_user_issues：获取分配给用户的问题

   • 可选输入：
     • userId（string）：用户 ID（省略则使用已认证用户）
     • includeArchived（boolean）：是否包含已归档的问题
     • limit（number, default: 50）：最大结果数

5. linear_add_comment：为问题添加评论

   • 必填输入：
     • issueId（string）：要评论的问题 ID
     • body（string）：评论文本（支持 Markdown）
   • 可选输入：
     • createAsUser（string）：自定义用户名
     • displayIconUrl（string）：自定义头像 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. “根据我之前告诉你的这个 bug 的信息，为身份验证系统创建一份 bug 报告” → 使用 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 License 许可。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。更多详情请参阅项目仓库中的 LICENSE 文件。