线性 MCP 服务器

线性 API的模型上下文协议服务器。

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

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装线性积分服务器：

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

手动安装

1. 为您的团队创建或获取 Linear 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"
      }
    }
  }
}

Related MCP server: Linear MCP Server

成分

工具

1. linear_create_issue ：创建一个新的线性问题

   • 必需输入：

     • 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 （string[]）：按标签过滤

     • priority （数字）：按优先级过滤

     • limit （数字，默认值：10）：最大结果数

4. linear_get_user_issues ：获取分配给用户的问题

   • 可选输入：

     • userId (字符串)：用户 ID（对于已验证的用户可省略）

     • includeArchived （布尔值）：包括存档问题

     • limit （数字，默认值：50）：最大结果数

5. linear_add_comment ：向问题添加评论

   • 必需输入：

     • issueId （字符串）：需要评论的问题 ID

     • body （字符串）：评论文本（支持 markdown）

   • 可选输入：

     • createAsUser （字符串）：自定义用户名

     • displayIconUrl (string): 自定义头像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 报告”→使用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 文件。