Cpropster Linear MCP Server

🚀 線性 MCP 服務器

線性 MCP 服務器是一款用於與 Linear API 交互的實用工具。它具備多個功能模塊，可幫助用戶獲取團隊、狀態、優先級等信息，還能創建和更新問題，為高效使用 Linear 平臺提供了便利。

🚀 快速開始

安裝依賴

可使用 npm 或 yarn 進行安裝：

npm install linear-sdk @types/node --save-dev

或

yarn add linear-sdk @types/node -D

初始化項目

創建 src/index.ts 文件，並添加以下代碼：

import { Linear } from '@linear/sdk';

const linear = new Linear({
  token: 'your_linear_token',
});

async function main() {
  try {
    const teams = await linear.teams.list();
    console.log('Teams:', teams);
    
    // 可選：執行其他操作，如創建問題
    const issue = await linear.issues.create({
      teamId: 'team_id', 
      title: 'Test Issue',
      description: 'This is a test issue.',
      assigneeId: 'assignee_id', // 可選
      stateId: 'state_id', // 可選
      priority: 0, // 可選，範圍是 0-4
    });
    console.log('Created Issue:', issue);
  } catch (error) {
    console.error('Error:', error);
  }
}

main();

運行

使用 TypeScript 編譯並運行：

npm run build && npm start

✨ 主要特性

• 獲取團隊：可列出所有團隊。
• 獲取狀態：能列出某個團隊的所有狀態。
• 獲取優先級：可列出某個團隊的所有優先級。
• 獲取標籤：能列出某個團隊的所有標籤。
• 獲取里程碑（時間跟蹤）：可列出某個團隊的所有里程碑。
• 獲取項目：可列出某個團隊的項目，還能可選指定團隊 ID 和返回數量。
• 獲取週期：能列出某個團隊的週期，不過需要指定團隊 ID。
• 創建問題：可新建一個問題，需指定團隊 ID、標題和其他可選項，如分配人 ID、狀態 ID 等。
• 更新問題：可修改現有問題的信息，需指定問題 ID 和其他可選參數。

📦 安裝指南

創建 Linear 應用

1. 登錄 Linear。
2. 進入設置 > 應用，點擊“創建新應用”。
3. 填寫應用名稱和描述，並選擇所需權限（建議最少權限）。

獲取令牌

在應用詳情頁，找到並複製 API 令牌。將此令牌添加到 .env 文件中：

LINEAR_TOKEN=your_token_here

💻 使用示例

基礎用法

獲取所有團隊

const teams = await linear.teams.list();

創建問題

const issue = await linear.issues.create({
  teamId: 'team_id',
  title: '新問題',
  description: '這是一個測試問題。',
  assigneeId: 'assignee_id', // 可選
});

高級用法

在初始化項目的代碼中，展示瞭如何獲取團隊列表並創建問題，同時包含了錯誤處理：

import { Linear } from '@linear/sdk';

const linear = new Linear({
  token: 'your_linear_token',
});

async function main() {
  try {
    const teams = await linear.teams.list();
    console.log('Teams:', teams);
    
    // 可選：執行其他操作，如創建問題
    const issue = await linear.issues.create({
      teamId: 'team_id', 
      title: 'Test Issue',
      description: 'This is a test issue.',
      assigneeId: 'assignee_id', // 可選
      stateId: 'state_id', // 可選
      priority: 0, // 可選，範圍是 0-4
    });
    console.log('Created Issue:', issue);
  } catch (error) {
    console.error('Error:', error);
  }
}

main();

📚 詳細文檔

教程

• 獲取團隊列表：調用 teams.list() 方法。
• 創建問題：使用 issues.create() 方法，傳遞必要參數。

常見問題

Q: 如何處理錯誤？

A: 使用 try-catch 語句捕捉異常，並在控制檯輸出錯誤信息：

try {
  // 操作代碼
} catch (error) {
  console.error('發生錯誤:', error);
}

Q: 是否支持多個團隊？

A: 是的，通過 teamId 參數指定操作針對的具體團隊。

🔧 技術細節

本項目使用 linear-sdk 與 Linear API 進行交互，通過 TypeScript 編寫代碼，利用 @types/node 提供類型支持。在運行時，使用 npm 或 yarn 管理依賴，通過 TypeScript 編譯後運行項目。

📄 許可證

本項目遵循 MIT 許可證。

⚠️ 重要提示

要避免提交敏感信息，確保 .env 文件不在版本控制系統中。

💡 使用建議

在代碼中通過環境變量訪問令牌，例如 process.env.LINEAR_TOKEN。

貢獻指南

歡迎提交問題和拉取請求到 GitHub 倉庫：linear-mcp