Linear MCP Server

🚀 Linear MCP 服務器

Linear MCP 服務器整合了 Linear 的官方 SDK 和 MCP 協議，具備類型安全、高效性能等特點，能為開發者提供穩定且強大的服務。

🚀 快速開始

要使用此項目，請確保安裝了以下依賴：

bun add @linear/sdk @modelcontextprotocol/sdk

啟動服務器前，配置環境變量 NEXT_PUBLIC_LINEAR_SDK_CONFIG。

{
  "url": "https://app.linear.app",
  "authType": "token"
}

然後運行：

bun dev

✨ 主要特性

• 類型安全：所有接口和方法均使用 TypeScript 定義，確保代碼的類型安全性。
• 高效性能：基於 Bun 運行時環境構建，提供卓越的執行效率。
• 集成開發工具包：整合了 Linear 的官方 SDK 和 MCP 協議 1.4.0 版本。

📦 安裝指南

安裝依賴

bun add @linear/sdk @modelcontextprotocol/sdk

啟動服務器

啟動前需配置環境變量 NEXT_PUBLIC_LINEAR_SDK_CONFIG：

{
  "url": "https://app.linear.app",
  "authType": "token"
}

之後運行啟動命令：

bun dev

📚 詳細文檔

配置參數

環境變量

• NEXT_PUBLIC_BASE_URL：設置為你的 Linear 基礎 URL，默認是 https://app.linear.app。
• NEXT_PUBLIC_WEB_BASE_URL：設置為你的 Web 應用程序的公開 URL。

其他配置

在 .env 文件中添加以下內容：

NEXT_PUBLIC_LINEAR_SDK_CONFIG=url=https://app.linear.app&authType=token

使用說明

快速入門

import { type Context } from '@modelcontextprotocol/sdk'

export async function getContext(): Promise<Context> {
  const config = new Configuration()
  const client = new LinearClient(config)
  return await client.getContext()
}

高級功能

團隊管理

• 獲取所有團隊：GET /api/teams
• 搜索特定團隊：支持按名稱或鍵過濾

項目操作

• 列出所有項目：GET /api/projects
• 創建新項目：POST /api/projects

🔧 技術細節

架構組件

• 前端界面：使用 React 和 Tailwind CSS 實現響應式設計。
• 後端邏輯：基於 Bun 搭建高效的服務器架構。

數據處理流程

1. 請求接收與解析
2. 參數校驗
3. 業務邏輯執行
4. 結果包裝與返回

錯誤處理機制

異常捕捉

• 網絡錯誤檢測
• HTTP 狀態碼處理
• 詳細錯誤日誌記錄

全局中間件

用於統一處理所有 API 請求和響應，確保系統穩定性。

📄 許可證

本項目遵循 MIT 許可證協議。更多詳情請參閱 LICENSE 文件。