AI导哈

Linear问题跟踪集成服务

一个通过Model Context Protocol（MCP）与Linear API集成的服务器，使LLM能够与Linear的问题跟踪系统进行交互。

  • by gerbal
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 gerbal/linear-mcp-server-1

使用说明

线性MCP服务器

A. 模型上下文协议 服务器 线性API.

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

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面线性集成服务器 史密瑟里:

npx -y @smithery/cli install @gerbal/linear-mcp-server-1 --client claude

手动安装

  1. 为您的团队创建或获取线性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：创建新的线性问题

    • 所需输入：
      • title （string）：发行标题
      • teamId （string）：在中创建问题的团队ID
    • 可选输入：
      • description （string）：问题描述（支持markdown）
      • priority （数字，0-4）：优先级（1=紧急，4=低）
      • status （string）：初始状态名称

  2. linear_update_issue：更新现有问题

    • 所需输入：
      • id （string）：要更新的问题ID
    • 可选输入：
      • title （string）：新标题
      • description （string）：新描述
      • priority （数字，0-4）：新优先级
      • status （string）：新状态名称

  3. linear_search_issues：使用灵活的筛选搜索问题

    • 可选输入：
      • query （string）：在标题/描述中搜索的文本
      • teamId （string）：按团队筛选
      • status （string）：按状态筛选
      • assigneeId （string）：按受让人筛选
      • labels （string[]）：按标签筛选
      • priority （数字）：按优先级筛选
      • limit （数字，默认值：10）：最大结果

  4. linear_get_user_issues：将问题分配给用户

    • 可选输入：
      • userId （string）：用户ID（对于经过身份验证的用户省略）
      • includeArchived （boolean）：包括已存档的问题
      • limit （数字，默认值：50）：最大结果

  5. linear_add_comment：为问题添加评论

    • 所需输入：
      • issueId （string）：要评论的问题ID
      • body （string）：注释文本（支持markdown）
    • 可选输入：
      • createAsUser （string）：自定义用户名
      • displayIconUrl （字符串）：自定义头像URL

资源

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

使用示例

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

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

  2. “根据我已经告诉你的关于这个bug的信息，为身份验证系统制作一份bug报告”→ use create_issue 创建具有适当详细信息和状态跟踪的新高优先级问题

  3. “查找所有正在进行的前端任务”→ use search_issues 在进行中的任务中查找前端相关问题

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

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

发展

  1. 安装依赖项：
npm install
  1. 在中配置线性API密钥 .env:
LINEAR_API_KEY=your_api_key_here
  1. 构建服务器：
npm run build

对于自动重建的开发：

npm run watch

许可证

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

相关 MCP