线性模型上下文协议服务器

一个提供MCP接口以访问Linear资源的线性模型上下文协议服务器实现,适用于开发者在Cursor中集成Linear的问题管理和资源访问功能。

  • by Iwark
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 iwark/linear-mcp-server

使用说明

线性MCP服务器

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

使用光标进行设置

  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. 在游标中配置:
  • 打开光标设置
  • 在MCP服务器部分添加新服务器
  • 选择类型: Command
  • 设置命令: sh /absolute/path/to/linear.sh

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

您可以从 线性设置页面.

  1. 启动服务器:
npm start

可用工具

创建问题

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

  • 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线性误差
  • 请求频率超限
  • 资源类型无效
  • 身份验证问题