Linear MCP

🚀 Linear MCP 服務器

這是一個用於通過 Cline 管理 Linear API 的 MCP 服務器。該服務器提供了一組工具，可用於管理 Linear 的問題、項目和團隊，助力用戶高效處理相關事務。

🚀 快速開始

你可以按照以下步驟快速搭建並使用 Linear MCP 服務器。

📦 安裝指南

1. 環境搭建

• 克隆倉庫。
• 安裝依賴：

npm install

• 複製 .env.example 到 .env：

cp .env.example .env

2. 認證方法

服務器支持兩種認證方式：

API Key（推薦）

1. 進入 Linear 設置。
2. 點擊“安全與訪問”部分。
3. 找到“個人 API 密鑰”部分。
4. 點擊“新建 API 密鑰”。
5. 為密鑰添加一個描述性標籤（例如：“Cline MCP”）。
6. 複製生成的令牌。
7. 將令牌添加到 .env 文件中：

LINEAR_API_KEY=your_api_key

OAuth 流程（備用）未實現

1. 在 https://linear.app/settings/api/applications 創建一個新的 OAuth 應用。
2. 配置 OAuth 環境變量在 .env 中：

LINEAR_CLIENT_ID=你的_oauth_client_id
LINEAR_CLIENT_SECRET=你的_oauth_client_secret
LINEAR_REDIRECT_URI=http://localhost:3000/callback

3. 運行服務器

• 構建服務器：

npm run build

• 啟動服務器：

npm start

4. Cline 集成

1. 打開你的 Cline MCP 設置文件：
   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. 添加 Linear MCP 服務器配置：

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "你的個人訪問令牌"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

✨ 主要特性

已支持的操作

• 問題管理：
  • ✅ 創建帶有完整信息的問題。
  • ✅ 更新現有問題的狀態、標題和描述。
  • ✅ 刪除問題。
  • ✅ 獲取所有問題的列表。
  • ✅ 根據篩選條件獲取問題。
• 項目管理：
  • ✅ 創建新項目。
  • ✅ 更新現有項目的名稱和描述。
  • ✅ 刪除項目。
  • ✅ 獲取所有項目的信息。
• 團隊管理：
  • ✅ 添加新的團隊成員。
  • ✅ 更新團隊成員的角色和權限。
  • ✅ 移除團隊成員。
  • ✅ 獲取所有團隊成員的列表。

開發中功能

• 問題評論：
  • ✅ 創建問題評論。
  • ✅ 更新現有評論的內容。
  • ✅ 刪除評論。
  • ✅ 獲取所有評論的列表。
• 標籤管理：
  • ✅ 添加新的標籤。
  • ✅ 更新現有標籤的顏色和名稱。
  • ✅ 刪除標籤。
  • ✅ 獲取所有標籤的列表。

💻 使用示例

開發指令

npm install  # 安裝依賴
npm run build  # 構建服務器
npm start  # 啟動服務器

接口示例

創建問題

POST /api/issues
{
  "title": "新問題",
  "description": "這是一個新的測試問題。",
  "projectId": "12345"
}

更新問題狀態

PUT /api/issues/12345
{
  "status": "已完成"
}

獲取所有項目

GET http://localhost:3000/api/projects

返回結果示例

{
  "data": {
    "projects": [
      {
        "_id": "12345",
        "name": "項目名稱",
        "description": "項目描述"
      }
    ]
  }
}

錯誤處理

• 400 Bad Request：請求格式錯誤或缺少必填參數。
• 401 Unauthorized：認證失敗。
• 404 Not Found：資源未找到。
• 500 Internal Server Error：服務器內部錯誤。