使用说明

项目简介

Linear MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 AI 智能体提供与 Linear 项目管理平台交互的能力。通过此服务器，AI 智能体可以利用预定义的工具，实现对 Linear 平台中的 issue、team 和 project 的自动化管理，例如创建 issue、查询 issue 列表、更新 issue 状态、列出团队和项目等。这使得 AI 智能体能够更有效地集成 Linear 的功能，提升工作效率。

主要功能点

Issue 管理：
- 创建新的 issue，支持自定义标题、描述、团队、负责人、优先级和标签。
- 列出 issue，支持按团队、负责人和状态进行灵活筛选。
- 更新已存在的 issue，可以修改标题、描述、状态、负责人和优先级等信息。
Team 管理：
- 列出工作区中的所有团队，方便 AI 智能体了解团队结构。
- 获取团队的详细信息，包括团队 ID、名称、Key 和描述。
Project 管理：
- 列出所有项目，并支持按团队进行筛选，帮助 AI 智能体定位项目。
- 查看项目的详细信息，包括项目名称、描述、状态和关联团队。

安装步骤

安装 Node.js：确保您的计算机上已安装 Node.js (v16 或更高版本)。您可以从 Node.js 官网下载并安装。
获取 Linear API Key：访问 Linear 开发者设置获取您的 Linear API Key。

安装 Linear MCP Server：使用 npm 全局安装 '@ibraheem4/linear-mcp' 包。

npm install -g @ibraheem4/linear-mcp

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用。MCP 客户端需要知道如何启动服务器。以下是针对不同 MCP 客户端的配置示例。您需要将以下 JSON 配置添加到您的 MCP 客户端配置文件中。

注意：以下配置中的 'command' 和 'args' 字段是 MCP 客户端连接 Linear MCP Server 的关键。'command' 指定了启动服务器的命令，'args' 是命令的参数。通常情况下，使用全局安装的 'npx @ibraheem4/linear-mcp' 命令即可启动服务器。

Claude Desktop 配置示例 (配置文件路径可能因操作系统而异):

{
  "mcpServers": {
    "linear-mcp": {
      "command": "npx",
      "args": ["@ibraheem4/linear-mcp"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"  // 请替换为您的 Linear API Key
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

VS Code Extension (Cline) 配置示例 (配置文件路径可能因操作系统而异):

{
  "mcpServers": {
    "linear-mcp": {
      "command": "npx",
      "args": ["@ibraheem4/linear-mcp"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"  // 请替换为您的 Linear API Key
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Cursor 配置示例 (配置方式请参考 Cursor 官方文档): Cursor 可能需要您直接在 Cursor 的设置中配置 MCP 服务器，配置方式与 Claude Desktop 和 VS Code Cline 类似，同样需要指定 'command' 为 'npx'，'args' 为 '["@ibraheem4/linear-mcp"]'，并在 'env' 中设置 'LINEAR_API_KEY'。

基本使用方法

启动 Linear MCP Server：在终端中运行 'npx @ibraheem4/linear-mcp' 命令启动服务器。请确保在运行命令前，您已经设置了 'LINEAR_API_KEY' 环境变量，或者在命令前直接指定，例如：'LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp'。
配置 MCP 客户端：根据您使用的 MCP 客户端（如 Claude Desktop, VS Code Cline, Cursor），按照上述 "服务器配置" 部分的说明，将 Linear MCP Server 添加到客户端的 MCP 服务器列表中，并启用。
在 MCP 客户端中使用工具：配置完成后，您的 MCP 客户端应该能够检测到 Linear MCP Server 提供的工具。您可以在客户端中通过自然语言指令或图形界面调用这些工具，与 Linear 平台进行交互，例如创建 issue、查询 issue 等。具体工具的使用方法请参考仓库 README.md 文件中 "Available Tools" 部分的详细描述和参数说明。

关键词