Linear MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows to interact with Linear resources, including creating issues, searching issues, and reading resources like organizations, issues, and teams through an MCP server interface

线性 MCP 服务器

线性模型上下文协议 (MCP) 服务器实现,提供用于访问线性资源的 MCP 接口。

使用光标设置

  1. 克隆存储库并安装依赖项:
git clone git@github.com:Iwark/linear-mcp-server.git cd linear-mcp-server npm install
  1. 创建启动脚本:
# Create linear.sh touch linear.sh chmod +x linear.sh # Add the following content export LINEAR_API_KEY="<YOUR LINEAR API KEY>" node /absolute/path/to/linear-mcp-server/index.js
  1. 在游标中配置:
  • 打开光标设置
  • 在 MCP 服务器部分添加新服务器
  • 选择类型: Command
  • 设置命令: sh /absolute/path/to/linear.sh

现在您可以在 Cursor 中使用 Linear MCP 服务器。

您可以从线性设置页面获取线性 API 密钥。

  1. 启动服务器:
npm start

可用工具

创建问题

使用指定参数创建新的线性问题:

  • title (必填):问题标题
  • teamId (必填):团队ID
  • description (可选):问题描述
  • priority (可选):问题优先级(0:无优先级,1:紧急,2:高,3:中,4:低)
  • stateId (可选):州 ID
  • assigneeId (可选):受让人ID
  • estimate (可选):问题估计
  • labelIds (可选):标签 ID 数组

搜索问题

使用查询字符串搜索线性问题。支持各种过滤器:

  • assignee:@me :显示分配给您的问题
  • priority:[value] :按优先级过滤
    • 数值(0-4)
    • 文本值:“无”、“紧急”、“高”、“中”、“低”
    • 注意: priority:high包括紧急和高优先级问题
  • state:[value]status:[value] :按州名称过滤
  • team:[value] :按团队名称过滤
  • label:[value] :按标签名称过滤
  • 标题和描述的自由文本搜索

读取资源

使用 URI 读取线性资源:

  • linear://organization - 组织详细信息
  • linear://issues - 问题列表
  • linear://issues/{id} - 具体问题详情
  • linear://teams - 团队列表
  • linear://teams/{id} - 具体团队详情

速率限制

服务器通过以下方式实现速率限制:

  • 每小时 1000 个请求限制
  • 自动请求跟踪
  • 每个响应中包含的指标

错误处理

服务器提供以下详细的错误消息:

  • 线性 API 错误
  • 超出速率限制
  • 无效的资源类型
  • 身份验证问题

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

通过 MCP 接口实现与 Linear 资源的交互,提供问题管理和资源检索功能,并支持速率限制和错误处理。

  1. Setup with Cursor
    1. Available Tools
      1. create-issue
      2. search-issues
      3. read-resource
    2. Rate Limiting
      1. Error Handling
        ID: zh2tj9gvsa