Linear

🚀 線性 MCP 服務器

這是一個用於與線性（Linear）交互的 Model Context Protocol (MCP) 服務器。該服務器允許 AI 助手通過 MCP 標準從線性獲取數據，為開發者提供了便捷的數據交互方式。

🚀 快速開始

此線性 MCP 服務器可讓 AI 助手通過 MCP 標準與線性進行數據交互。以下是使用該服務器的基本步驟，助你快速上手。

✨ 主要特性

• 獲取指定用戶的待辦事項票證，可通過用戶 ID 或電子郵件地址進行查詢

📦 安裝指南

1. 克隆此倉庫。
2. 安裝依賴：

   npm install
   

3. 在項目根目錄創建一個 .env 文件（基於 .env.example 模板）：

   LINEAR_API_KEY=你的線性API密鑰
   

   從 線性開發者控制檯 獲取你的線性 API 密鑰

💻 使用示例

基礎用法

開發環境運行

運行帶有熱重載功能的開發服務器：

npm run dev

生產環境運行

構建 TypeScript 代碼：

npm run build

運行構建後的程序：

npm start

高級用法

與 MCP 客戶端配合使用

此 MCP 服務器實現了標準的 MCP 協議，可與任何 MCP 客戶端配合使用。服務器提供的工具包括：

使用 Claude Code

要將此 MCP 服務器與 Claude Code 配合使用，請運行以下命令：

claude mcp add linear-mcp-server -- node dist/index.js

這會將線性 MCP 服務器註冊到 Claude Code，使你能夠直接從 Claude 對話中訪問線性票證。

獲取用戶待辦事項票證

獲取指定用戶處於“Todo”狀態的所有票證。 參數：

• userId（可選）：用戶的 ID
• email（可選）：用戶的電子郵件地址

注意：必須提供 userId 或 email 中的任意一個。

示例響應：

[
  {
    "id": "issue-id",
    "identifier": "PROJ-123",
    "title": "修復登錄問題",
    "url": "https://linear.app/...",
    "priority": 1
  },
  ...
]

🤝 貢獻指南

歡迎貢獻！請隨意提交拉取請求，一起讓這個項目變得更完善。