Linear MCP 服务器

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

使用 Cursor 设置

1. 克隆仓库并安装依赖：

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

2. 创建一个启动脚本：

# 创建 linear.sh
touch linear.sh
chmod +x linear.sh

# 添加以下内容
export LINEAR_API_KEY="<YOUR LINEAR API KEY>"
node /absolute/path/to/linear-mcp-server/index.js

3. 在 Cursor 中配置：

• 打开 Cursor 设置
• 在 MCP 服务器部分添加一个新的服务器
• 选择类型：Command
• 设置命令：sh /absolute/path/to/linear.sh

现在你可以从 Cursor 内部使用 Linear MCP 服务器了。

你可以从 Linear 设置页面 获取你的 Linear API 密钥。

3. 启动服务器：

npm start

可用工具

create-issue

创建一个带有指定参数的新的 Linear issue：

• title (必需): Issue 标题
• teamId (必需): 团队 ID
• description (可选): Issue 描述
• priority (可选): Issue 优先级 (0: 无优先级, 1: 紧急, 2: 高, 3: 中, 4: 低)
• stateId (可选): 状态 ID
• assigneeId (可选): 负责人 ID
• estimate (可选): Issue 预估
• labelIds (可选): 标签 ID 数组

search-issues

使用查询字符串搜索 Linear issues。 支持各种过滤器：

• assignee:@me: 显示分配给你的 issues
• priority:[value]: 按优先级过滤
  • 数值 (0-4)
  • 文本值: "no", "urgent", "high", "medium", "low"
  • 注意: priority:high 包括紧急和高优先级 issues
• state:[value] 或 status:[value]: 按状态名称过滤
• team:[value]: 按团队名称过滤
• label:[value]: 按标签名称过滤
• 自由文本搜索标题和描述

read-resource

使用 URI 读取 Linear 资源：

• linear://organization - 组织详情
• linear://issues - Issue 列表
• linear://issues/{id} - 特定 issue 详情
• linear://teams - 团队列表
• linear://teams/{id} - 特定团队详情

速率限制

服务器实现了速率限制：

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

错误处理

服务器提供详细的错误消息，用于：

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