L

Linear 问题服务

@gerbal/linear-mcp-server-1
0 Stars 18 次浏览 gerbal 更新于 2026-08-23

允许大型语言模型（LLMs）与Linear的问题跟踪系统集成，从而使它们能够通过Linear API创建、更新、搜索和评论问题。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "linear": {
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear"
      ],
      "command": "npx",
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

服务介绍

Linear MCP 服务器

smithery 徽章

这是一个用于 Linear API 的 模型上下文协议 服务器。

此服务器通过 MCP 提供与 Linear 问题跟踪系统的集成，允许大型语言模型（LLM）与 Linear 问题进行交互。

安装

通过 Smithery 安装

要通过 Smithery 自动安装适用于 Claude 桌面版的 Linear 集成服务器：

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

手动安装

  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 (数字, 0-4): 新优先级
      • status (字符串): 新状态名称

  3. linear_search_issues: 使用灵活过滤搜索问题

    • 可选输入：
      • query (字符串): 在标题/描述中搜索的文字
      • teamId (字符串): 按团队筛选
      • status (字符串): 按状态筛选
      • assigneeId (字符串): 按指派者筛选
      • labels (字符串数组): 按标签筛选
      • priority (数字): 按优先级筛选
      • limit (数字, 默认值: 10): 最大结果数

  4. linear_get_user_issues: 获取分配给用户的任务

    • 可选输入：
      • userId (字符串): 用户 ID（省略则为已验证用户）
      • includeArchived (布尔值): 包含归档的问题
      • limit (数字, 默认值: 50): 最大结果数

  5. linear_add_comment: 向问题添加评论

    • 必需输入：
      • issueId (字符串): 要评论的问题 ID
      • body (字符串): 评论文本（支持 Markdown）
    • 可选输入：
      • createAsUser (字符串): 自定义用户名
      • displayIconUrl (字符串): 自定义头像 URL

资源

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

使用示例

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

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

  2. "根据我已经告诉您的关于这个错误的信息，为认证系统创建一个错误报告" → 使用 create_issue 创建一个新的高优先级问题，并包含适当的详细信息和状态跟踪

  3. "查找所有正在进行的前端任务" → 使用 search_issues 定位与前端相关的正在进行的任务

  4. "给我一份移动应用开发问题最近更新的摘要" → 使用 search_issues 确定相关的问题，然后通过 linear-issue:///{issueId} 获取问题详情并展示最近的活动和评论

  5. "移动团队当前的工作量是多少？" → 结合使用 linear-team:///{teamId}/issues 和 search_issues 分析移动团队中问题的分布和优先级

开发

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

对于带有自动重建功能的开发环境：

npm run watch

许可证

此MCP服务器采用MIT许可证。这意味着您可以自由地使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。更多详情，请参阅项目仓库中的LICENSE文件。

查看源码 项目主页