线性 MCP 服务器

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

使用光标设置

1. 克隆存储库并安装依赖项：

git clone git@github.com:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install

2. 创建启动脚本：

# 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

3. 在游标中配置：

• 打开光标设置

• 在 MCP 服务器部分添加新服务器

• 选择类型： Command

• 设置命令： sh /absolute/path/to/linear.sh

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

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

3. 启动服务器：

npm start

Related MCP server: MCP Linear.app Server

可用工具

创建问题

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

• 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 错误

• 超出速率限制

• 无效的资源类型

• 身份验证问题