Linear MCP 服务器

一个用于与 Linear API 交互的 MCP 服务器。该服务器提供了一套工具，用于通过 Cline 管理 Linear 的 issue、项目和团队。

设置指南

1. 获取 Linear API Token

1. 前往 Linear：Settings > API > OAuth application > "Cline MCP"
2. 在 "Developer Token" 下，点击 "Create & copy token"
3. 选择 "Application" 并复制生成的 token

2. 配置 Cline MCP

1. 打开你的 Cline MCP 设置文件：

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/GlobalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. 添加 Linear MCP 服务器配置：

   {
     "mcpServers": {
       "linear": {
         "command": "npx",
         "args": ["mcp-server-linear"],
         "env": {
           "LINEAR_ACCESS_TOKEN": "your_linear_api_token_here"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

就这样！服务器会在需要时自动下载并通过 npx 运行。

如果你使用 Cline/Roo，你也可以简单地告诉它 install the MCP from https://github.com/dvcrn/mcp-server-linear，它会完成剩下的工作。

注意: 将 your_linear_api_token_here 替换为你第一步中生成的 API token。

可用操作

该服务器目前支持以下操作：

Issue 管理

• ✅ 创建 issue，支持所有字段（标题、描述、团队、项目、父/子关系等）
• ✅ 更新现有 issue（优先级、描述等）
• ✅ 删除 issue（单个或批量删除）
• ✅ 通过过滤和标识符搜索 issue
• ✅ 将 issue 与项目关联
• ✅ 创建父/子 issue 关系
• ✅ 评论管理（创建、更新、删除评论）
• ✅ 评论解决处理（解决/取消解决评论）
• ✅ 从附件创建客户需求

项目管理

• ✅ 创建项目，并关联 issue
• ✅ 获取项目信息
• ✅ 列出所有项目，可选择过滤
• ✅ 将 issue 与项目关联
• ✅ 项目里程碑管理（创建、更新、删除）
• ✅ 列出和过滤项目里程碑

团队管理

• ✅ 获取团队信息（包括状态和工作流程详情）
• ✅ 访问团队状态和标签

身份验证

• ✅ 个人访问令牌 (PAT) 身份验证
• ✅ 安全的 token 存储

批量操作

• ✅ 批量创建 issue
• ✅ 批量删除 issue

批量更新 (测试中)

• 🚧 批量 issue 更新（已实现并行处理，需要测试）

开发中的功能

以下功能目前正在开发中：

Issue 管理

• 🚧 复杂的搜索过滤器
• 🚧 大型结果集的分页支持

元数据操作

• 🚧 标签管理（创建/更新/分配）

项目管理

• ✅ 项目里程碑管理
• 🚧 项目模板支持
• 🚧 高级项目操作

身份验证

• 🚧 OAuth 流程，支持自动 token 刷新

性能 & 安全

• 🚧 速率限制
• 🚧 详细的日志记录
• 🚧 负载测试和优化

父/子 Issue 关系

该服务器支持创建和管理 issue 之间的层级关系：

创建子 Issue

你可以通过在创建新 issue 时指定父 issue 的 UUID 来创建子 issue：

{
  "title": "子任务实现",
  "description": "实现父任务的这个特定部分",
  "teamId": "team_uuid",
  "parentId": "parent_issue_uuid"
}

注意：parentId 必须是父 issue 的 UUID，而不是 issue 标识符（例如，使用 UUID，而不是 "ENG-123"）。

使用多个 Linear 工作区

你可以通过多次添加 Linear MCP 服务器并使用不同的 TOOL_PREFIX 值来连接到多个 Linear 工作区。 这允许你在同一个 Cline 环境中处理不同的 Linear 工作区。

配置示例

{
  "mcpServers": {
    "company1-linear": {
      "command": "npx",
      "args": ["mcp-server-linear"],
      "env": {
        "LINEAR_ACCESS_TOKEN": "your_company1_linear_token_here",
        "TOOL_PREFIX": "company1"
      },
      "disabled": false,
      "autoApprove": []
    },
    "company2-linear": {
      "command": "npx",
      "args": ["mcp-server-linear"],
      "env": {
        "LINEAR_ACCESS_TOKEN": "your_company2_linear_token_here",
        "TOOL_PREFIX": "company2"
      },
      "disabled": false,
      "autoApprove": []
    },
    "company3-linear": {
      "command": "npx",
      "args": ["mcp-server-linear"],
      "env": {
        "LINEAR_ACCESS_TOKEN": "your_company3_linear_token_here",
        "TOOL_PREFIX": "company3"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

工作原理

当你设置 TOOL_PREFIX 值时：

1. 所有工具名称都将以它为前缀（例如，company1_linear_create_issue）
2. 工具描述包含前缀（例如，“对于 'company1' Linear 工作区：创建一个新的 issue”）

这可以清楚地表明每个工具正在哪个工作区上运行，并防止不同 Linear 实例之间的冲突。

贡献

如果你想为这个 MCP 服务器的开发做出贡献，请按照以下步骤操作：

1. 克隆仓库
2. 安装依赖项：

   npm install
   

3. 复制 .env.example 到 .env：

   cp .env.example .env
   

4. 将你的 Linear API token 添加到 .env：

   LINEAR_ACCESS_TOKEN=your_personal_access_token
   

开发

# 安装依赖项
npm install

# 运行测试
npm test

# 构建并在本地运行服务器
npm run build
npm start

# 或者使用自动重新加载的开发模式
npm run dev

集成测试

集成测试验证身份验证和 API 调用是否正常工作：

1. 在 .env 中设置身份验证（建议使用 PAT 进行测试）
2. 运行集成测试：

   npm run test:integration
   

对于 OAuth 测试：

1. 在 .env 中配置 OAuth 凭据：

   LINEAR_CLIENT_ID=your_oauth_client_id
   LINEAR_CLIENT_SECRET=your_oauth_client_secret
   LINEAR_REDIRECT_URI=http://localhost:3000/callback
   

2. 从 src/__tests__/auth.integration.test.ts 中的 OAuth 测试中删除 .skip
3. 运行集成测试