Linear MCP 服务器

一个用于 Linear API 的 模型上下文协议 服务器。

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

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Linear Integration Server：

npx -y @smithery/cli install @gerbal/linear-mcp-server-1 --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",
        "@modelcontextprotocol/server-linear"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

组件

工具

1. linear_create_issue: 创建一个新的 Linear issue

   • 必需输入：
     • title (string): Issue 标题
     • teamId (string): 在哪个团队中创建 issue 的团队 ID
   • 可选输入：
     • description (string): Issue 描述 (支持 markdown)
     • priority (number, 0-4): 优先级 (1=紧急, 4=低)
     • status (string): 初始状态名称

2. linear_update_issue: 更新现有 issue

   • 必需输入：
     • id (string): 要更新的 Issue ID
   • 可选输入：
     • title (string): 新标题
     • description (string): 新描述
     • priority (number, 0-4): 新优先级
     • status (string): 新状态名称

3. linear_search_issues: 使用灵活的筛选条件搜索 issue

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

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

   • 可选输入：
     • userId (string): 用户 ID (省略则为已验证用户)
     • includeArchived (boolean): 包含已归档的 issue
     • limit (number, default: 50): 最大结果数

5. linear_add_comment: 向 issue 添加评论

   • 必需输入：
     • issueId (string): 要评论的 Issue ID
     • body (string): 评论文本 (支持 markdown)
   • 可选输入：
     • createAsUser (string): 自定义用户名
     • displayIconUrl (string): 自定义头像 URL

资源

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

使用示例

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

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

2. "根据我已经告诉你的关于这个 bug 的信息，为身份验证系统创建一个 bug 报告" → 使用 create_issue 创建一个新的高优先级 issue，其中包含适当的详细信息和状态跟踪

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

4. "给我一个关于移动应用程序开发 issue 的最新更新摘要" → 使用 search_issues 识别相关的 issue，然后 linear-issue:///{issueId} 获取 issue 详细信息并显示最近的活动和评论

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

开发

1. 安装依赖项：

npm install

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

LINEAR_API_KEY=your_api_key_here

3. 构建服务器：

npm run build

对于具有自动重建功能的开发：

npm run watch

许可证

此 MCP 服务器在 MIT 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。