项目简介

Linear MCP服务器是一个实现了Model Context Protocol (MCP) 的后端应用，它专注于为大型语言模型 (LLM) 客户端提供与 Linear issue跟踪系统集成的能力。通过标准化的MCP协议，该服务器允许LLM应用安全、可扩展地访问和操作Linear中的issue数据，从而增强LLM在项目管理和工作流自动化方面的能力。

主要功能点

问题搜索：允许LLM客户端通过关键词搜索Linear中的issue，快速检索相关任务和问题。
问题详情：支持获取指定issue的详细信息，包括标题、描述、状态、评论等。
问题更新：允许LLM客户端更新issue的标题和描述等信息，方便快捷地修改任务内容。
添加评论：支持为issue添加评论，方便LLM客户端进行协作和沟通。
标准MCP协议：遵循MCP协议规范，易于集成到支持MCP协议的LLM客户端，如Claude Desktop和Cursor。
多种安装方式：支持通过npm、Deno以及Docker等多种方式安装和运行，满足不同用户的需求。
零安装快速启动：提供'npx'命令，无需本地安装即可快速启动服务器进行体验。

安装步骤

方式一：使用 npm (Node.js)

确保已安装 Node.js 和 npm。

全局安装 'mcp-linear'：

npm install -g @scoutos/mcp-linear

方式二：使用 Deno

确保已安装 Deno。

直接运行（无需安装）：

deno run --allow-env --allow-stdio https://deno.land/x/mcp_linear/main.ts

或者，安装后运行：

deno install --allow-env --allow-stdio -n mcp-linear https://deno.land/x/mcp_linear/main.ts
mcp-linear

方式三：使用 Docker

确保已安装 Docker。

使用Docker命令运行：

docker run --rm -e LINEAR_API_KEY=your_linear_api_key_here scoutos/mcp-linear:latest

服务器配置

要将Linear MCP服务器与MCP客户端（如Claude Desktop 或 Cursor）连接，您需要在客户端的配置文件中添加服务器信息。以下是针对 Claude Desktop 和 Cursor 的配置示例。

Claude Desktop 配置 ( '~/.config/Claude Desktop/claude_desktop_config.json' )

{
  "mcp": {
    "servers": [
      {
        "name": "Linear",  // 服务器名称，可自定义
        "command": "npx @scoutos/mcp-linear", // 服务器启动命令，根据安装方式选择
        "env": {
          "LINEAR_API_KEY": "your_linear_api_key_here" // 您的Linear API Key，**必填**
        }
      }
    ]
  }
}

Cursor 配置 (settings.json)

{
  "ai.mcp.servers": [
    {
      "name": "Linear",  // 服务器名称，可自定义
      "command": "npx @scoutos/mcp-linear", // 服务器启动命令，根据安装方式选择
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here" // 您的Linear API Key，**必填**
      }
    }
  ]
}

配置参数说明:

'name': MCP服务器的名称，用于在客户端中标识和选择。您可以自定义此名称。
'command': 启动Linear MCP服务器的命令。请根据您选择的安装方式（npm, Deno, Docker）选择相应的命令。
- 使用 'npm' 安装： '"mcp-linear"'
- 使用 'npx' 零安装： '"npx @scoutos/mcp-linear"'
- 使用 'Deno' 安装： '"mcp-linear"'
- 使用 'deno run' 运行： '"deno run --allow-env --allow-stdio https://deno.land/x/mcp_linear/main.ts"'
- 使用 'Docker' 运行： '"docker run --rm -e LINEAR_API_KEY=your_linear_api_key_here scoutos/mcp-linear:latest"' (注意: 'LINEAR_API_KEY' 需要在command中配置)
'env': 环境变量配置。
- 'LINEAR_API_KEY': 必须配置。请替换 '"your_linear_api_key_here"' 为您在Linear中生成的API Key。您需要在 Linear settings 中创建API Key。

重要提示: 请务必将 '"your_linear_api_key_here"' 替换为您真实的Linear API Key，否则服务器将无法连接到Linear API。

基本使用方法

启动服务器：根据您的安装方式，在终端中运行相应的启动命令。
配置客户端：将上述提供的JSON配置添加到您的MCP客户端（Claude Desktop 或 Cursor）的配置文件中，并确保配置了正确的 'LINEAR_API_KEY' 和 'command'。
重启客户端：重启您的MCP客户端，使配置生效。
在客户端中使用：在客户端中，您可以向LLM助手提问，例如：
- "Search for Linear issues containing 'bug'" (搜索包含关键词 "bug" 的 Linear issue)
- "Get details of Linear issue TEST-123" (获取 ID 为 "TEST-123" 的 Linear issue 的详细信息)
- "Update Linear issue TEST-123 title to 'Fixed bug'" (将 ID 为 "TEST-123" 的 Linear issue 的标题更新为 "Fixed bug")
- "Add comment 'This issue is resolved' to Linear issue TEST-123" (为 ID 为 "TEST-123" 的 Linear issue 添加评论 "This issue is resolved")
LLM助手应该能够检测到Linear MCP服务器并使用其提供的工具来检索和操作Linear issue数据。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息