MCP Linear Server

🚀 線性 MCP 集成服務器

線性 MCP 集成服務器通過模型上下文協議 (MCP) 提供線性集成功能，允許 AI 模型與 Linear 進行交互，用於問題跟蹤和項目管理。

🚀 快速開始

此服務器可通過以下步驟進行開發設置和部署：

開發設置

1. 克隆倉庫。
2. 安裝依賴項：

   npm install
   

3. 創建 .env 文件並添加 Linear API 密鑰：

   LINEAR_API_KEY=your_api_key_here
   

4. 運行服務器：

   npm run dev
   

Smithery 部署

此服務器可部署於 Smithery.ai，使用提供的配置文件。

先決條件

• Smithery 賬戶
• Linear API 密鑰

部署步驟

1. 添加此倉庫到 Smithery 或 claim 已有服務。
2. 訪問部署選項卡（僅限認證所有者）。
3. 配置部署參數，設置 Linear API 密鑰。
4. 發佈服務器。

本地測試

1. 構建 Docker 鏡像：

   docker build -t linear-mcp-server .
   

2. 運行容器並設置環境變量：

   docker run -e LINEAR_API_KEY=your_api_key_here linear-mcp-server
   

3. 或使用 MCP 檢查工具：

   npm run inspect
   

✨ 主要特性

該服務器通過 MCP 接口提供以下工具：

linear_create_issue

創建新的 Linear 問題，支持以下參數：

• title（必需）：問題標題
• teamId（必需）：要創建問題的團隊 ID
• description（可選）：問題描述
• labels（可選）：問題標籤列表

linear_list_issues

列出指定團隊的所有問題，支持以下參數：

• teamId（必需）：目標團隊 ID
• filter（可選）：過濾條件（如狀態、標籤等）

linear_get_issue

獲取單個問題的詳細信息，支持以下參數：

• teamId（必需）：目標團隊 ID
• issueId（必需）：要獲取的問題 ID

linear_update_issue

更新現有問題的信息，支持以下參數：

• teamId（必需）：目標團隊 ID
• issueId（必需）：要更新的問題 ID
• title（可選）：新標題
• description（可選）：新描述
• labels（可選）：新標籤列表

linear_delete_issue

刪除指定問題，支持以下參數：

• teamId（必需）：目標團隊 ID
• issueId（必需）：要刪除的問題 ID

🔧 技術細節

項目架構

• 使用 TypeScript 編寫，確保代碼的強類型和可維護性。
• 基於 Linear SDK 構建，提供對 Linear API 的封裝和支持。
• 配合 MCP 協議，實現與 AI 模型的無縫交互。

核心功能

• 問題創建、讀取、更新和刪除操作。
• 團隊間的問題隔離與權限控制。
• 支持自定義過濾器和排序邏輯。
• 提供詳細的錯誤處理和日誌記錄。

📈 性能與可靠性

緩存系統

• 使用內存緩存加速頻繁訪問的操作。
• 設置合理的過期時間，平衡一致性和性能。
• 支持手動刷新緩存以確保數據一致性。

錯誤處理

• 全面的錯誤捕捉和處理機制。
• 友好的錯誤信息反饋。
• 自動重試策略應對臨時性故障。

性能優化

• 線程池與連接池管理。
• 併發請求的負載均衡。
• 效率優化的數據訪問模式。
• 分頁機制處理大數量集。

📦 依賴項

• @linear/sdk：Linear API 客戶端庫
• @modelcontextprotocol/sdk：MCP 服務器實現
• zod：運行時類型檢查與驗證
• dotenv：環境變量管理工具
• TypeScript 開發套件及相關工具

完整的依賴列表請查看 package.json。

📚 詳細文檔

配置文件

Dockerfile

定義了服務器的構建流程：

• 使用 Node.js 18 Alpine 作為基礎鏡像。
• 安裝依賴項並構建 TypeScript 代碼。
• 設置運行命令。

smithery.yaml

配置服務器啟動參數：

• 指定運行命令。
• 定義所需配置參數（Linear API 密鑰）。
• 管理環境變量。