关键词

Linearissue跟踪项目管理任务管理工作流管理

使用说明

项目简介

Linear MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在作为 LLM 客户端（如 Cline）的后端，桥接 Linear 强大的 issue 跟踪和项目管理 API。通过此服务器，LLM 应用可以安全、可扩展地访问和操作 Linear 中的数据，实现智能化的工作流自动化和信息检索。

主要功能点

  • 问题管理: 支持全面的 issue 生命周期管理，包括创建 issue（支持标题、描述、团队、项目等所有字段）、更新 issue 属性（优先级、描述等）、删除 issue（单个或批量）、高级 issue 搜索和过滤、issue 与项目关联、以及创建父子 issue 关系。
  • 项目管理: 允许创建包含关联 issue 的新项目、获取项目详细信息、以及将 issue 关联到特定项目。
  • 团队管理: 提供访问团队信息的能力，包括团队的状态和工作流详情，以及访问团队的状态和标签信息。
  • 身份验证: 支持个人访问令牌 (PAT) 认证方式，保证访问安全。
  • 批量操作: 支持批量创建和批量删除 issue，提高操作效率。

安装步骤

  1. 克隆仓库

    git clone https://github.com/cline/linear-mcp.git

  2. 进入项目目录

    cd linear-mcp

  3. 安装依赖

    npm install

  4. 复制环境变量文件

    cp .env.example .env

  5. 配置身份验证

    • 推荐使用个人访问令牌 (PAT) 认证:
      • 访问 Linear API 设置，在 "OAuth application" > "Cline MCP" 下创建并复制 "Developer Token"。
      • 将复制的 Token 粘贴到 '.env' 文件中的 'LINEAR_ACCESS_TOKEN' 变量。
    • OAuth 认证 (未完全实现): OAuth 认证流程尚未完全实现，推荐使用 PAT 认证。如果需要尝试 OAuth 认证，请参考 README.md 文档配置 OAuth 相关的环境变量。

  6. 构建服务器

    npm run build

  7. 启动服务器

    npm start

    启动成功后，服务器将在 stdio 上监听 MCP 客户端的连接。

服务器配置 (MCP 客户端配置)

要将 Linear MCP Server 集成到 MCP 客户端（例如 Cline），您需要配置 MCP 服务器的启动命令和参数。以下是一个典型的 Cline MCP 服务器配置示例，请根据您的实际 'linear-mcp' 仓库路径进行调整：

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_ACCESS_TOKEN": "your_personal_access_token" // 如果您在 .env 文件中配置了 PAT，也可以在此处配置，或留空
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置参数说明:

  • '"server name"': '"linear"' - 服务器名称，在 Cline 中用于标识和调用此服务器。
  • '"command"': '"node"' - 启动服务器的命令，这里使用 Node.js 运行时环境。
  • '"args"': '["/path/to/linear-mcp/build/index.js"]' - 启动命令的参数，指向构建后的服务器入口文件 'index.js' 的绝对路径。请将 '/path/to/linear-mcp' 替换为您本地 'linear-mcp' 仓库的实际路径。
  • '"env"': '{ "LINEAR_ACCESS_TOKEN": "your_personal_access_token" }' - 环境变量配置。如果选择 PAT 认证，可以在这里直接配置 'LINEAR_ACCESS_TOKEN'，或者确保在运行服务器的环境中已经设置了该环境变量。
  • '"disabled"': 'false' - 设置为 'false' 表示启用该 MCP 服务器。
  • '"autoApprove"': '[]' - 自动批准的工具列表，默认为空，表示所有工具调用都需要用户手动批准。

请将以上 JSON 配置添加到 Cline 的 MCP 设置文件 ('cline_mcp_settings.json') 中，并根据您的实际情况修改 'command' 和 'args' 中的路径。

基本使用方法

配置完成后，您可以在 Cline 中通过 'linear' 服务器调用 Linear MCP Server 提供的各种工具。工具列表及其详细参数定义可以在 'src/core/types/tool.types.ts' 文件中的 'toolSchemas' 找到。

例如，在 Cline 中，您可以使用自然语言指令，结合 'linear_create_issue' 工具来创建一个新的 Linear issue，或者使用 'linear_search_issues' 工具来搜索 issue。 Cline 会将您的指令转换为 MCP 请求，发送给 Linear MCP Server 处理，并将结果返回给您。

请注意: OAuth 认证流程和部分功能（如评论、复杂搜索、分页、标签/周期管理、项目模板、高级项目操作等）仍在开发中， bulk updates 功能处于测试阶段。请关注仓库的更新以获取最新的功能和改进。

信息

分类

开发者工具

访问项目