Linear MCP 服务器

一个实现了线性模型上下文协议（MCP）的服务器，提供了通过MCP接口访问Linear资源的功能。

使用Cursor进行设置

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. 在Cursor中配置：
   • 打开Cursor设置
   • 在MCP服务器部分添加一个新的服务器
   • 选择类型：命令
   • 设置命令：sh /absolute/path/to/linear.sh

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

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

1. 启动服务器：

npm start

可用工具

create-issue

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

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

search-issues

使用查询字符串搜索Linear问题。支持多种过滤器：

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

read-resource

使用URI读取Linear资源：

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

请求限制

该服务器实现请求限制如下：

• 每小时最多1000次请求
• 自动请求跟踪
• 每个响应中包含指标信息

错误处理

对于以下情况，服务器提供详细的错误消息：

• Linear API错误
• 超过请求限制
• 无效的资源类型
• 认证问题