Linear MCP Server

🚀 線性 MCP 服務器

本項目是一個模型上下文協議 (MCP) 服務器，提供了與 Linear 的 API 交互的工具。藉助它，AI 代理能夠通過 Linear 平臺對問題、項目和團隊進行編程管理，為項目的自動化管理提供了便利。

🚀 快速開始

1. 從 Linear 的開發者設置 獲取您的 Linear API 密鑰。
2. 使用您的 API 密鑰運行：

LINEAR_API_KEY=your-api-key npx @ibraha7m/linear-mcp-server

✨ 主要特性

• 問題管理
  • 可創建新的問題，並且帶有可自定義屬性，如標題、描述、團隊、分配人、優先級、標籤等。
  • 能列出問題，還帶有靈活的過濾選項，例如團隊、分配人、狀態。
  • 支持更新現有問題的相關信息，包括標題、描述、狀態、分配人、優先級。
• 團隊管理
  • 可列出工作區中的所有團隊。
  • 能訪問團隊詳細信息，包括 ID、名稱、密鑰和描述。
• 項目管理
  • 可列出所有項目，還能選擇團隊進行過濾。
  • 能查看項目詳細信息，包括名稱、描述、狀態和關聯的團隊。

📦 安裝指南

先決條件

• Node.js (v16 或更高版本)
• 帶有 API 訪問權限的 Linear 賬戶
• 帶適當權限的 Linear API 密鑰

安裝命令

通過 npm 安裝：

npm install -g @ibraha7m/linear-mcp-server

💻 使用示例

基礎用法

# 開發模式（自動重建）
npm run dev

# 生產模式
npm start

高級用法

創建問題

{
  "command": "createIssue",
  "arguments": {
    "title": "問題標題",
    "description": "問題描述",
    "projectId": "項目 ID",
    "priority": 1,
    "assigneeId": "分配人 ID"
  }
}

更新問題

{
  "command": "updateIssue",
  "arguments": {
    "issueId": "問題 ID",
    "title": "新標題",
    "description": "新描述",
    "status": "新狀態",
    "assigneeId": "新分配人 ID",
    "priority": 2
  }
}

🔧 技術細節

• 使用 TypeScript 和 Linear SDK (@linear/sdk v37.0.0)
• MCP SDK (@modelcontextprotocol/sdk v0.6.0)

服務器使用標準輸入輸出進行通信，並實現模型上下文協議以實現與 AI 代理的無縫集成。

📄 許可證

MIT

⚠️ 重要提示

這是一個自定義實現。有關官方 Cline 線性 MCP 服務器，請參見 cline/linear-mcp。