Linear MCP 服务器

一个用于 Linear API 的 Model Context Protocol 服务器，实现了与 Linear 问题跟踪系统的集成，允许大语言模型 (LLM) 与其交互。

安装

使用 Smithery 安装

通过 Smithery 自动安装 Linear Integration Server for 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"
      }
    }
  }
}

组件

工具

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 (数字)：新优先级
     • 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 (字符串)：以哪个用户的身份创建
     • anonymous (布尔值)：是否匿名

资源

• Linear API 文档

开发

1. 安装依赖：

npm install

1. 在 .env 中配置 Linear API 密钥：

LINEAR_API_KEY=your_api_key_here

1. 构建服务器：

npm run build

对于开发时的自动重建：

npm run watch

许可证

此 MCP 服务器根据 MIT License 发布。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT License 的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。

以上是完整的中文翻译，内容与英文原文一致。