关键词

Linearissue跟踪任务管理项目管理缺陷管理

使用说明

项目简介

Linear MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它允许 LLM 客户端通过标准化的方式与 Linear issue tracking 系统进行交互。该服务器提供了一系列工具，用于创建、检索、更新和删除 Linear issues，以及管理项目和团队信息。

主要功能点

  • 创建和管理 Linear issues (包括子 issues)。
  • 检索和搜索 Linear issues，支持高级过滤。
  • 更新和删除 Linear issues。
  • 添加 issue 评论。
  • 获取 Linear 项目和团队信息。
  • 支持 "me" 关键词进行 issue 自我分配。

安装步骤

  1. 克隆仓库:

    git clone [repository-url]
cd linear-mcp

    请将 '[repository-url]' 替换为仓库的实际 URL。

  2. 安装依赖并构建: 确保你已安装 Bun 运行时 (v1.0.0 或更高版本)。然后运行以下命令安装项目依赖并构建项目：

    bun install
bun run build

  3. 配置环境变量: 你需要设置 Linear API 密钥作为环境变量。在你的 shell 配置文件（如 '.bashrc' 或 '.zshrc'）中添加以下行，并将 'your_api_key' 替换为你的 Linear API 令牌。

    export LINEAR_API_KEY=your_api_key

    或者，你也可以在运行服务器时直接设置环境变量：

    LINEAR_API_KEY=your_api_key node build/index.js

服务器配置

为了让 MCP 客户端（如 Cline 或 Claude Desktop）连接到 Linear MCP Server，你需要在客户端的 MCP 设置中添加以下配置。请注意将 '/absolute/path/to/linear-mcp/build/index.js' 替换为 'linear-mcp/build/index.js' 文件的绝对路径。

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/absolute/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_api_key"
      }
    }
  }
}

配置参数说明:

  • 'server name': 'linear' (服务器名称，客户端配置中用于标识)
  • 'command': 'node' (启动服务器的命令，这里使用 Node.js 运行)
  • 'args': '["/absolute/path/to/linear-mcp/build/index.js"]' (命令参数，指向服务器入口文件，请务必修改为你的实际绝对路径)
  • 'env': '{"LINEAR_API_KEY": "your_api_key"}' (环境变量，用于传递 Linear API 密钥，请替换 'your_api_key' 为你的实际 API 密钥)

基本使用方法

  1. 启动服务器: 在项目根目录下，运行以下命令启动 Linear MCP Server：

    bun run dev  # 开发模式
# 或
bun run build # 构建模式后，运行 node build/index.js

    服务器默认使用 Stdio 传输协议，并在标准输入/输出流上与 MCP 客户端通信。

  2. 配置 MCP 客户端: 根据你的 MCP 客户端（如 Cline 或 Claude Desktop）的文档，配置 MCP 服务器连接。你需要提供上面 服务器配置 中生成的 JSON 配置信息。

  3. 使用 MCP 客户端调用工具: 一旦客户端成功连接到 Linear MCP Server，你就可以在客户端中使用服务器提供的工具，例如创建 issue、搜索 issue 等。具体的工具名称和参数请参考仓库 README.md 文件中 "Available MCP Tools" 部分的描述和 Input Schema。

注意: 请确保 Linear API_KEY 配置正确，并且你的 Linear 账户具有 API 访问权限。

信息

分类

开发者工具

访问项目