Linear MCP Server 0yc

🚀 Linear MCP 服務器

Linear MCP 服務器是一款用於與 Linear 平臺進行交互的實用工具。它具備豐富的功能，可實現對問題、週期、項目等相關實體的創建、更新和檢索操作。

🚀 快速開始

Linear MCP 服務器為開發者提供了便捷的方式與 Linear 平臺交互。以下是使用該服務器的基本步驟。

📦 安裝指南

先決條件

• Node.js（版本 14 或更高）
• npm（版本 6 或更高）

下載代碼

git clone [repository-url]
cd linear-mcp-server

安裝依賴項

npm install

🔧 配置

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

NEXT_PUBLIC_LINEAR_CLIENT_ID=your_client_id
NEXT_PUBLIC_LINEAR_CLIENT_SECRET=your_client_secret
NEXT_PUBLIC_LINEAR_REDIRECT_URI=your_redirect_uri
NEXT_PUBLIC_LINEAR_ENVIRONMENT=production

✨ 主要特性

問題管理

• 創建問題
• 更新問題
• 獲取單個問題
• 獲取所有問題

週期管理

• 創建週期
• 更新週期
• 獲取單個週期
• 獲取所有周期

項目管理

• 創建項目
• 更新項目
• 獲取單個項目
• 獲取所有項目

💻 使用示例

基礎用法

# 創建問題
npm run create-issue -- --title "問題標題" --description "問題描述" --assigneeId user-id --stateId state-id --priority 0 --estimate 1 --cycleId cycle-id --projectId project-id --labelIds label-id,label-id2

# 更新問題
npm run update-issue -- --issueId issue-id --title "新標題" --description "新描述" --assigneeId user-id --stateId state-id --priority 0 --estimate 1 --cycleId cycle-id --projectId project-id --labelIds label-id,label-id2

📚 詳細文檔

調試

如果在使用過程中遇到問題，請參考以下調試步驟：

• 檢查環境變量是否正確設置
• 確保 Linear API 正常運行（可訪問 status.linear.app）
• 查看服務器日誌以獲取更多錯誤信息

開發

安裝依賴項

npm install

啟動開發服務器

npm run dev

🔧 技術細節

在使用 Linear MCP 服務器時，需要注意以下安全事項：

⚠️ 重要提示

• 不要提交敏感令牌：.env 文件和其他包含令牌的文件應排除在版本控制之外。
• 使用環境變量：始終在 MCP 配置中使用環境變量，而不是硬編碼令牌。
• 限制權限：創建 Linear OAuth 應用程序時，請僅授予所需的權限。
• 定期輪換令牌：定期生成新令牌並更新配置。

📄 許可證

本項目採用 MIT 許可證。