Jerhadf Linear MCP Server

🚀 線性 MCP 服務端

這是一個專為 Linear API 構建的 Model Context Protocol 服務端，其核心價值在於將大型語言模型（LLM）與 Linear 的問題跟蹤系統完美集成，實現兩者之間的高效協作。

🚀 快速開始

該服務器藉助 MCP 搭建起與 Linear 問題交互的橋樑，讓大型語言模型（LLM）能夠輕鬆處理 Linear 問題。

✨ 主要特性

• 實現大型語言模型（LLM）與 Linear 問題跟蹤系統的集成。
• 提供多種工具，可對 Linear 問題和評論進行創建、更新和查詢操作。

📦 安裝指南

1. 創建或獲取您的團隊的 Linear API 密鑰：https://linear.app/YOUR-TEAM/settings/api
2. 將服務器配置添加到 Claude 桌面：
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

💻 使用示例

基礎用法

1. 創建一個問題

{
  "tool": "linear_create_issue",
  "args": {
    "title": "修復登錄頁面的錯誤",
    "description": "用戶報告登錄頁面加載緩慢，需要調查並修復。",
    "priority": 2,
    "status": "打開"
  }
}

2. 更新一個問題

{
  "tool": "linear_update_issue",
  "args": {
    "id": "issue_12345",
    "title": "登錄頁面加載緩慢的問題",
    "priority": 1,
    "status": "進行中"
  }
}

3. 創建一個評論

{
  "tool": "linear_create_comment",
  "args": {
    "issueId": "issue_12345",
    "content": "我們已經識別到可能是 CDN 的問題，請提供更多日誌以供進一步調查。"
  }
}

📚 詳細文檔

組件

工具

1. linear_create_issue：創建新的 Linear 問題
   • 必填輸入：
     • title (字符串)：問題標題
     • teamId (字符串)：要創建問題的團隊 ID
   • 可選輸入：
     • description (字符串)：問題描述（支持 Markdown）
     • priority (數字，0 - 4)：優先級水平（1 = 緊急，4 = 低）
     • status (字符串)：初始狀態名稱
2. linear_update_issue：更新現有問題
   • 必填輸入：
     • id (字符串)：要更新的問題 ID
   • 可選輸入：
     • title (字符串)：新標題
     • description (字符串)：新描述
     • priority (數字)：新優先級
     • status (字符串)：新狀態名稱
3. linear_query_issues：查詢問題
   • 可選輸入：
     • projectId (字符串)：要查詢的項目 ID（可選）
     • userId (字符串)：要查詢的用戶 ID（可選）
   • 輸出：
     • 數組：包含查詢到的問題列表
4. linear_create_comment：創建評論
   • 必填輸入：
     • issueId (字符串)：要添加評論的問題 ID
     • content (字符串)：評論內容
   • 輸出：
     • 對象：表示新創建的評論
5. linear_update_comment：更新評論
   • 必填輸入：
     • commentId (字符串)：要更新的評論 ID
     • content (字符串)：新的評論內容
   • 輸出：
     • 對象：表示已更新的評論

資源

• 問題：通過 linear_create_issue 和 linear_update_issue 進行操作。
• 評論：通過 linear_create_comment 和 linear_update_comment 進行操作。

開發

要開發此 MCP 服務器，您可以按照以下步驟操作：

1. 安裝依賴：

npm install

2. 配置環境變量：
   • 設置 LINEAR_API_KEY 環境變量為您的 Linear API 密鑰。
3. 運行服務器：
   • 一次性運行：

     npm start
     

   • 監視文件更改（開發模式）：

     npm run watch
     

📄 許可證

此 MCP 服務器根據 MIT License 發佈。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT License 的條款和條件。有關詳細信息，請參閱項目存儲庫中的 LICENSE 文件。