金大哥 - Iwark_linear-mcp-server MCP 详情

article

README

🚀 线性 MCP 服务器

线性 MCP 服务器是一个提供线性资源访问接口的线性模型上下文协议 (MCP) 服务器实现，可帮助用户便捷地访问和管理线性资源。

🚀 快速开始

克隆代码库并安装依赖项

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

创建启动脚本

# 创建 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

在 Cursor 中进行配置

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

现在，您可以在 Cursor 中使用线性 MCP 服务器。

您可以在 Linear 设置页面获取您的 Linear API 密钥。

启动服务器

npm start

✨ 主要特性

可用工具

create-issue

创建新的线性问题，指定参数如下：

title（必需）：问题标题
teamId（必需）：团队 ID
description（可选）：问题描述
priority（可选）：问题优先级（0: 无优先级，1: 紧急，2: 高，3: 中等，4: 低）
stateId（可选）：状态 ID
assigneeId（可选）：分配给执行人 ID
estimate（可选）：问题估算
labelIds（可选）：标签 ID 数组

search-issues

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

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://organization - 组织信息
linear://issues - 问题列表
linear://issues/{id} - 特定问题详细信息
linear://teams - 团队列表
linear://teams/{id} - 特定团队详细信息

速率限制

服务器实现以下速率限制：

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

错误处理

服务器提供详细的错误消息，包括：

线性 API 错误
请求过多
无效资源类型
认证问题

Iwark_linear-mcp-server