Linear MCP Server

基本能力

产品定位

Linear MCP Server 是一个连接 Claude 和 Linear 任务管理系统的桥梁服务，旨在通过 MCP 协议实现 AI 助手与外部工具的交互。

核心功能

1. get_ticket - 获取特定 Linear 票证的详细信息
2. get_my_issues - 列出分配给当前用户的问题，可按状态筛选
3. add_comment - 向 Linear 票证添加评论
4. create_issue - 在 Linear 中创建新问题
5. get_teams - 获取可用的团队列表

适用场景

• 在开发环境中集成 Linear 任务管理功能
• 通过 AI 助手自动化处理 Linear 中的任务和问题
• 在代码编辑器中直接管理 Linear 任务

工具列表

1. get_ticket：获取票证的详细信息，包括状态、优先级、分配者和团队等。
2. get_my_issues：列出分配给当前用户的问题，支持按状态筛选。
3. add_comment：向现有票证添加新评论。
4. create_issue：在 Linear 中创建新问题。
5. get_teams：获取可用的团队列表以供参考。

常见问题解答

• 如何获取 Linear API 密钥？ 从 Linear 账户设置中的“个人 API 密钥”部分生成。
• 是否支持分页？ 目前对大型结果集的分页支持有限（限制为 20 个问题）。
• 如何处理图像？ 从 Markdown 中提取图像 URL，下载到本地临时目录，并转换为 base64 格式。

使用教程

使用依赖

1. 需要 Node.js 运行时环境。
2. 需要 Linear API 密钥。

安装教程

1. 从 Linear 账户设置获取 API 密钥。
2. 在 VS Code 中一键安装或手动配置 MCP 服务器。

VS Code 配置示例：

{
  "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}"
        }
      }
    }
  }
}

调试方式

1. 确保环境变量 LINEAR_API_KEY 已正确设置。
2. 运行 MCP 服务器并检查标准输入/输出通信。
3. 验证工具调用是否返回预期结果。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。