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 /絕對路徑/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} - 特定團隊詳情。