Linear MCP Server 1

线性MCP服务器

该服务器通过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

1. 将服务器配置添加到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）：初始状态名称

1. linear_update_issue：更新现有问题

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

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

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

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

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

1. 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的问题

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

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

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

1. “移动团队目前的工作量是多少？”→ 结合 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文件。