Iwark Linear MCP Server

🚀 線性 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 錯誤
• 請求過多
• 無效資源類型
• 認證問題