Linear 线性 MCP 服务端

这是一个为 Linear API 构建的 Model Context Protocol 服务端，用于将大型语言模型（LLM）与 Linear 的问题跟踪系统集成起来。

该服务器通过 MCP 提供与 Linear 问题的交互，允许 LLM 处理 Linear 问题。

安装

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

2. 将服务器配置添加到 Claude 桌面：

   • 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 问题

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

2. linear_update_issue：更新现有问题

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

3. linear_query_issues：查询问题

   • 可选输入：
     • projectId (字符串)：要查询的项目 ID（可选）
     • userId (字符串)：要查询的用户 ID（可选）
   • 输出：
     • 数组：包含查询到的问题列表

4. linear_create_comment：创建评论

   • 必填输入：
     • issueId (字符串)：要添加评论的问题 ID
     • content (字符串)：评论内容
   • 输出：
     • 对象：表示新创建的评论

5. linear_update_comment：更新评论

   • 必填输入：
     • commentId (字符串)：要更新的评论 ID
     • content (字符串)：新的评论内容
   • 输出：
     • 对象：表示已更新的评论

资源

• 问题：通过 linear_create_issue 和 linear_update_issue 进行操作。
• 评论：通过 linear_create_comment 和 linear_update_comment 进行操作。

使用示例

1. 创建一个问题：

{
  "tool": "linear_create_issue",
  "args": {
    "title": "修复登录页面的错误",
    "description": "用户报告登录页面加载缓慢，需要调查并修复。",
    "priority": 2,
    "status": "打开"
  }
}

2. 更新一个问题：

{
  "tool": "linear_update_issue",
  "args": {
    "id": "issue_12345",
    "title": "登录页面加载缓慢的问题",
    "priority": 1,
    "status": "进行中"
  }
}

3. 创建一个评论：

{
  "tool": "linear_create_comment",
  "args": {
    "issueId": "issue_12345",
    "content": "我们已经识别到可能是 CDN 的问题，请提供更多日志以供进一步调查。"
  }
}

开发

要开发此 MCP 服务器，您可以按照以下步骤操作：

1. 安装依赖：

npm install

2. 配置环境变量：

   • 设置 LINEAR_API_KEY 环境变量为您的 Linear API 密钥。

3. 运行服务器：

   • 一次性运行：

     npm start
     

   • 监视文件更改（开发模式）：

     npm run watch
     

许可证

此 MCP 服务器根据 MIT License 发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT License 的条款和条件。有关详细信息，请参阅项目存储库中的 LICENSE 文件。

以上为完整翻译内容。