线性 MCP 服务器

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

安装

通过 Smithery 安装

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

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

手动安装

为您的团队创建或获取 Linear API 密钥： https://linear.app/YOUR-TEAM/settings/api
将服务器配置添加到 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"
      }
    }
  }
}

成分

工具

linear_create_issue ：创建一个新的线性问题
- 必需输入：
  - title （字符串）：问题标题
  - teamId （字符串）：创建问题的团队 ID
- 可选输入：
  - description （字符串）：问题描述（支持 markdown）
  - priority （数字，0-4）：优先级（1=紧急，4=低）
  - status （字符串）：初始状态名称
linear_update_issue ：更新现有问题
- 必需输入：
  - id （字符串）：要更新的问题 ID
- 可选输入：
  - title （字符串）：新标题
  - description （字符串）：新描述
  - priority （数字，0-4）：新的优先级
  - status （字符串）：新状态名称
linear_search_issues ：使用灵活过滤来搜索问题
- 可选输入：
  - query （字符串）：在标题/描述中搜索的文本
  - teamId （字符串）：按团队过滤
  - status （字符串）：按状态过滤
  - assigneeId （字符串）：按受让人过滤
  - labels （string[]）：按标签过滤
  - priority （数字）：按优先级过滤
  - limit （数字，默认值：10）：最大结果数
linear_get_user_issues ：获取分配给用户的问题
- 可选输入：
  - userId (字符串)：用户 ID（对于已验证的用户可省略）
  - includeArchived （布尔值）：包括存档问题
  - limit （数字，默认值：50）：最大结果数
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 进行交互的一些示例提示：

“显示我所有高优先级问题”→执行search_issues工具和/或linear-user:///{userId}/assigned来查找分配给您的优先级为 1 的问题
“根据我已经告诉你的关于这个 bug 的信息，为身份验证系统创建一个 bug 报告”→使用create_issue创建一个具有适当详细信息和状态跟踪的新的高优先级问题
“查找所有正在进行的前端任务”→使用search_issues来定位正在进行的任务中与前端相关的问题
“给我一份关于移动应用程序开发问题的最新更新摘要”→使用search_issues识别相关问题，然后linear-issue:///{issueId}获取问题详细信息并显示最近的活动和评论
“移动团队目前的工作量是多少？” → 结合linear-team:///{teamId}/issues和search_issues来分析移动团队的问题分布和优先级

发展

安装依赖项：

npm install

在.env中配置 Linear API 密钥：

LINEAR_API_KEY=your_api_key_here

构建服务器：

npm run build

对于使用自动重建的开发：

npm run watch

执照

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