🚀 线性 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 /绝对路径/linear-mcp-server/index.js

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

在游标中进行配置

• 打开游标设置。
• 添加新的服务器到 MCP 服务器部分。
• 选择类型：Command。
• 设置命令：sh /绝对路径/linear.sh。

启动服务器

npm start

现在你可以在游标内使用线性 MCP 服务器。

✨ 主要特性

速率限制

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

错误处理

服务器提供详细的错误消息，包括线性 API 错误、请求超限、无效资源类型和认证问题。

📦 安装指南

按照上述快速开始部分的步骤进行操作，即可完成服务器的安装和启动。

💻 使用示例

可用工具

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} - 特定团队详情。