Madebynando MCP Linear Server

🚀 Linear MCP 集成服務器

Linear MCP 集成服務器是一款用於連接並集成 Linear 工具的中間件。它藉助模型上下文協議（Model Context Protocol），實現與 Claude 等 AI 模型的交互，提供了一系列功能，可用於創建、搜索和管理 Linear 項目中的問題與任務。

🚀 快速開始

若你想快速啟動 Linear MCP 集成服務器，可參考以下不同方式的設置步驟。

開發者設置

環境配置

1. 下載並安裝 Node.js 和 npm。
2. 創建 config 文件夾，並在其中添加 env 文件，內容如下：

   LINEAR_API_KEY=your_linear_api_key
   

3. 在項目根目錄下創建 package.json 文件，內容如下：

   {
     "name": "linear-mcp-server",
     "version": "1.0.0",
     "scripts": {
       "start": "node dist/server.js"
     },
     "dependencies": {
       "@linear/sdk": "^2.0.0",
       "@modelcontextprotocol/sdk": "^1.0.0",
       "zod": "^1.0.0",
       "dotenv": "^16.3.1"
     }
   }
   

依賴安裝

在項目根目錄運行以下命令以安裝所需依賴：

npm install

啟動服務器

使用以下命令啟動 MCP 服務器：

npm start

Docker 設置

鏡像構建

創建 Dockerfile 文件，內容如下：

FROM node:16

WORKDIR /app

COPY package.json ./
COPY config/ ./

RUN npm install

CMD ["node", "dist/server.js"]

Compose 文件

創建 docker-compose.yml 文件，內容如下：

version: '3'
services:
  mcp-server:
    build: .
    ports:
      - "8080:8080"
    environment:
      - LINEAR_API_KEY=your_linear_api_key

啟動服務

運行以下命令啟動 Docker 服務：

docker-compose up --build

✨ 主要特性

工具端點

• linear_create_issue：可創建一個新的 Linear 問題，支持設置標題、描述、團隊 ID、優先級和狀態。
• linear_search_issues：能根據查詢條件、團隊、狀態、分配人、優先級和限制數搜索 Linear 問題。
• linear_sprint_issues：獲取指定團隊當前衝刺或迭代中的所有問題。
• linear_search_teams：搜索並檢索 Linear 團隊，可按名稱進行過濾。
• linear_filter_sprint_issues：根據狀態過濾指定團隊當前衝刺或迭代中的問題。
• linear_get_workflow_states：獲取指定團隊的所有可用工作流狀態（即問題的狀態）。
• linear_list_projects：獲取所有項目的列表及其 ID，還可按團隊進行篩選。

💻 使用示例

在 Cursor 中的使用

無 Docker 配置

1. 打開 Cursor 設置菜單。
2. 進入“MCP 服務器”部分。
3. 點擊“添加 MCP 服務器”。
4. 填寫以下信息：
   • 名稱：linear-mcp-server
   • 運輸類型：命令行
   • 命令：env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js
5. 保存設置。

Docker 配置

1. 打開 Cursor 設置菜單。
2. 進入“MCP 服務器”部分。
3. 點擊“添加 MCP 服務器”。
4. 填寫以下信息：
   • 名稱：linear-mcp-server
   • 運輸類型：命令行
   • 命令：docker exec -i mcp-linear-server node dist/server.js
5. 保存設置。

指示 Claude 使用

Claude 可以通過以下 MCP 端點與 Linear 進行交互：

創建問題

使用 linear_create_issue 端點創建新問題：

POST /api/linear/create-issue
Content-Type: application/json

{
  "title": "問題標題",
  "description": "問題描述",
  "teamId": "團隊ID",
  "priority": "優先級",
  "status": "狀態"
}

搜索問題

通過 linear_search_issues 端點搜索問題：

GET /api/linear/search-issues?query=查詢條件

示例響應

{
  "id": "12345",
  "title": "功能開發任務",
  "description": "實現新用戶認證模塊",
  "teamId": "001",
  "priority": "高",
  "status": "進行中"
}

🔧 技術細節

• 技術棧：基於 Node.js，使用 Linear SDK 和 MCP 協議實現。
• 錯誤處理：包括 API 超時保護、自動重連、詳細日誌記錄和優雅關閉處理。
• 監控與維護：提供心跳監測以確保連接健康。

📄 許可證

文檔未提及相關許可證信息。

⚠️ 重要提示

• 確保 LINEAR_API_KEY 設置正確且有效。
• 定期檢查和更新依賴以獲取最新功能和安全補丁。
• 在生產環境中，建議配置錯誤處理和日誌記錄機制。