MCP Server Linearapp

🚀 線性 MCP 服務器使用說明

這是一個用於與 Linear 平臺交互的 MCP（模塊化命令處理器）服務器。它允許通過命令行或集成工具執行各種任務，如創建、更新和查詢問題、管理團隊和項目等。

🚀 快速開始

安裝依賴項

運行以下命令安裝所需的包：

npm install

配置 API 密鑰

將 Linear 提供的 API 密鑰添加到 .env 文件中：

LINEAR_API_KEY=your_api_key_here

構建服務器

構建服務器以開始使用：

npm run build

開發時，可以使用以下命令實現自動重建：

npm run watch

✨ 主要特性

本服務器支持多種與 Linear 平臺交互的操作，涵蓋問題的創建、更新、評論添加、搜索，項目信息獲取，團隊成員管理以及標籤管理等功能。

💻 使用示例

基礎用法

創建新問題

要創建一個新的問題，請使用 linear_create_issue 命令並指定必要的參數。

linear_create_issue --title "新的認證系統故障" --description "報告身份驗證頁面上的錯誤。"

更新現有問題

要更新現有問題的屬性（如優先級或狀態），請使用 linear_update_issue。

linear_update_issue --issue-id FRONT-123 --priority 緊急

添加評論

要向問題添加評論，請使用 linear_add_comment 命令並指定問題 ID 和評論內容。

linear_add_comment --issue-id LOGIN-456 "已識別根本原因：密碼字段未正確加密。"

搜索問題

使用 linear_search_issues 命令搜索符合條件的問題。

linear_search_issues --status 進行中 --label 前端

獲取項目信息

要獲取特定項目的詳細信息，請使用 linear_get_project 並指定項目 ID。

linear_get_project --project-id MOBILE-APP

團隊管理

獲取團隊成員列表

要列出某個團隊的成員，請使用 linear_get_team_members。

linear_get_team_members --team-id frontend-team

獲取用戶所屬團隊

要查看當前用戶所屬的所有團隊，請運行 linear_get_user_teams。

linear_get_user_teams

標籤管理

創建新標籤

使用 linear_create_tag 命令創建新的問題標籤。

linear_create_tag --name backlog

更新標籤屬性

要更新現有標籤的屬性，請使用 linear_update_tag。

linear_update_tag --tag-id ui-refactor --color 藍色

高級用法

創建問題並添加評論

1. 使用 linear_create_issue 創建一個問題：

linear_create_issue --title "新的認證系統故障" --description "報告身份驗證頁面上的錯誤。"

2. 使用 linear_add_comment 添加評論到該問題：

linear_add_comment --issue-id 新的認證系統故障 --comment "已識別根本原因：密碼字段未正確加密。"

搜索和過濾問題

使用以下命令搜索特定類型的問題並應用篩選器：

linear_search_issues --status 已解決 --label 前端

📚 詳細文檔

項目結構

• src/：包含所有源代碼文件。
• commands/：包含定義的命令模塊。
• config/：包含配置文件和環境變量。
• index.js：應用程序入口點。

常見問題

如何獲取 API 密鑰？

訪問 Linear 平臺的“用戶設置”頁面，找到“開發者工具”部分，即可獲取 API 密鑰。

支持哪些命令？

當前版本支持以下命令：

• linear_create_issue
• linear_update_issue
• linear_add_comment
• linear_search_issues
• linear_get_project
• linear_get_team_members

更多命令正在開發中。

貢獻指南

歡迎社區貢獻！請參考項目倉庫中的 CONTRIBUTING.md 文件瞭解如何參與開發。

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。這意味著你可以自由使用、修改和分發軟件，前提是符合 MIT 許可證的條款和條件。有關詳細信息，請參閱項目倉庫中的 LICENSE 文件。