Linear MCP Server

🚀 線性MCP服務器

線性MCP服務器是一個實現線性GraphQL API的MCP（模型上下文協議）服務器，它能讓AI助手與線性項目管理系統進行交互，為項目管理提供了便捷的途徑。

✨ 主要特性

• 可通過MCP工具訪問線性GraphQL API。
• 支持使用線性API密鑰進行身份驗證。
• 能夠獲取和修改與用戶、團隊、項目和問題相關的數據。
• 可以創建、更新和評論問題。
• 支持添加和刪除標籤。
• 允許創建項目。
• 提供完整的工具文檔。

📦 安裝指南

通過Smithery

1. 訪問Smithery網站並登錄。
2. 在“添加服務器”部分找到線性MCP服務器。
3. 根據提示完成安裝和配置。

手動安裝

npm install --save @emmett-deen/linear-mcp-server

📚 詳細文檔

配置

創建一個.env文件並添加以下內容：

PORT=8080  # 可選，默認為3000
API_KEY=your_api_key_here

啟動服務器

node index.js

先決條件

• Node.js版本12或更高
• npm版本6或更高
• 線性API密鑰

安裝說明

安裝依賴項

npm install

運行服務器

node index.js --token your_api_token_here

在Claude Desktop上的配置

1. 打開Claude Desktop的設置。
2. 添加新的連接，選擇線性MCP服務器作為提供商。
3. 輸入服務器地址和API密鑰。

示例用法

一旦與Claude Desktop連接，可以使用以下提示：

• “顯示我所有的線性問題”
• “在前端團隊創建一個新問題，標題為‘修復登錄bug’”
• “將問題FE-123的狀態更改為‘進行中’”
• “將問題BE-456指派給John Smith”
• “向問題UI-789添加評論：‘此問題需要在週五前解決’”

開發

設置開發環境

git clone https://github.com/yourusername/linear-mcp-server.git
cd linear-mcp-server
npm install
npm run dev -- --token your_api_token_here

擴展服務器

1. 參考TOOLS.md文檔中的實現指南。
2. 確保遵循src目錄中的現有代碼結構。
3. 更新文檔以反映更改。

貢獻和開發

設置開發環境

git clone https://github.com/yourusername/linear-mcp-server.git
cd linear-mcp-server
npm install
npm run dev

發佈到npm

1. 更新package.json中的版本：

npm version patch  # 或 minor，或 major

2. 構建項目：

npm run build

3. 確保已登錄到npm：

npm login

4. 發佈到npm：

npm publish --access public

5. 對於Smithery註冊表，請與Smithery團隊聯繫以獲取服務器在目錄中的列出。

💻 使用示例

基礎用法

const { createIssue } = require('@emmett-deen/linear-mcp-server');

createIssue({
  title: '修復登錄問題',
  description: '需要在週五前解決此問題。',
  assignee: 'john.smith@example.com',
  labels: ['bug', 'high-priority']
});

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。