jerhadf_linear-mcp-server

🚀 线性 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 进行操作。

💻 使用示例

基础用法

创建一个问题

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

更新一个问题

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

创建一个评论

{
  "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 文件。