Linear MCP 服务器

概述

本项目实现了一个模型上下文协议 (MCP) 服务器，作为 Claude 和 Linear 任务/问题管理系统之间的桥梁。它允许 Claude 通过以下工具与 Linear 交互：

1. get_ticket - 检索有关特定 Linear 工单的详细信息
2. get_my_issues - 列出分配给当前用户的问题，并按状态进行过滤
3. add_comment - 向 Linear 工单添加评论
4. create_issue - 在 Linear 中创建新问题
5. get_teams - 检索可供参考的可用团队

安装

无需直接安装。正确配置后，Claude 集成将自动下载并使用该软件包。

用法

1. 从您的 Linear 帐户设置 获取 Linear API 密钥 - 点击“个人 API 密钥”下的“新建 API 密钥”。

2. 如下所示在您的代码编辑器中配置 MCP 服务器。

与 VS Code 一起使用

一键安装：

将其添加到您的 settings JSON 文件中：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "linear_api_key",
        "description": "Linear API Key",
        "password": true
      }
    ],
    "servers": {
      "linear": {
        "command": "npx",
        "args": [
          "-y",
          "@larryhudson/linear-mcp-server"
        ],
        "env": {
          "LINEAR_API_KEY": "${input:linear_api_key}"
        }
      }
    }
  }
}

与 Cursor IDE 一起使用

将其添加到 MCP config JSON 文件中：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@larryhudson/linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

与 Claude 桌面应用程序一起使用

将其添加到您的 MCP 配置 JSON 文件中：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@larryhudson/linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

与 Cline VS Code 扩展一起使用

将其添加到 MCP config JSON 文件中：

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@larryhudson/linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "<YOUR_API_KEY>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

环境变量

• LINEAR_API_KEY - 您的 Linear API 密钥（必需）

工作原理

该服务器基于以下关键技术构建：

• 模型上下文协议 (MCP) - 允许 AI 助手与外部工具和 API 交互的框架
• Linear SDK - 用于与 Linear API 通信的客户端库
• Node.js - JavaScript 运行时环境
• Zod - 用于工具参数的类型验证库

主要特点

工单检索

• 获取全面的工单详细信息，包括状态、优先级、受让人和团队
• 获取完整的描述和所有评论
• 处理带有嵌入式图像的 Markdown 内容
• 下载并包含工单描述中的图像

问题列表

• 检索分配给当前用户的问题
• 按状态过滤（活动、待办事项、已完成、已取消或全部）
• 返回一个格式化的表格，其中包含每个问题的关键信息

添加评论

• 允许向现有工单添加新评论
• 提供成功创建评论的确认

技术实现细节

1. 图像处理

   • 使用正则表达式从 Markdown 中提取图像 URL
   • 将图像下载到本地临时目录
   • 将图像转换为 base64 以包含在 MCP 响应中
   • 使用 URL 的 MD5 哈希创建唯一文件名

2. Linear API 集成

   • 使用 Linear API 密钥进行身份验证
   • 检索问题、工单、评论和用户信息
   • 格式化数据以供人工阅读显示

3. 错误处理

   • 优雅地处理 API 错误、缺少工单和下载失败
   • 向用户提供有意义的错误消息

运行服务器

服务器使用 MCP 协议通过标准输入/输出 (stdio) 与 Claude 通信。它需要：

• Linear API 密钥（在代码中配置）
• Node.js 运行时环境
• package.json 中指定的依赖包

项目结构

这是一个相对简单的 Node.js 应用程序，只有一个主源文件 (index.ts)，它定义了 MCP 服务器、工具和相关的辅助函数。它使用 TypeScript 来保证类型安全和更好的开发者体验。

依赖项

• @modelcontextprotocol/sdk: 核心 MCP 实现
• @linear/sdk: Linear API 客户端
• dotenv: 环境变量管理
• node-fetch: 用于图像下载的 HTTP 客户端
• zod: 用于工具参数的模式验证

局限性和潜在改进

• 对大型结果集的支持有限（目前限制为 20 个问题）
• 可以改进各种边缘情况的错误处理
• 图像下载可以从更好的 MIME 类型检测中受益
• 考虑添加更多用于管理问题的工具（更新状态、更改受让人等）
• 支持在创建问题或添加评论时添加附件