MCP Linear Server

🚀 線性 MCP 集成服務器

該服務器藉助模型上下文協議 (MCP) 提供線性集成功能，能讓 AI 模型與線性進行交互，實現問題跟蹤和項目管理。

🚀 快速開始

若想使用此服務器，可參考後續在 Cursor 中使用的步驟，或參考指示 Claude 使用的相關端點信息。

✨ 主要特性

該服務器通過 MCP 接口提供了一系列實用工具：

linear_create_issue

用於創建新的線性問題，具備以下參數：

• title（必需）：問題的標題。
• teamId（必需）：要創建問題的團隊 ID。
• description（可選）：問題描述，支持 Markdown 格式。
• priority（可選）：優先級水平，範圍為 0 - 4。
• status（可選）：初始狀態名稱。

linear_search_issues

可使用靈活的過濾條件搜索線性問題，參數如下：

• query（可選）：在標題或描述中搜索的文本。
• teamId（可選）：按團隊進行過濾。
• status（可選）：按狀態進行過濾。
• assigneeId（可選）：按分配人進行過濾。
• priority（可選）：優先級水平，範圍為 0 - 4。
• limit（可選，默認值：10）：要返回的最大結果數。

linear_sprint_issues

用於獲取當前衝刺/迭代中的所有問題，參數如下：

• teamId（必需）：要獲取衝刺問題的團隊 ID。

linear_search_teams

可搜索並檢索線性團隊，參數如下：

• query（可選）：按團隊名稱搜索的文本。

linear_filter_sprint_issues

按狀態過濾當前衝刺的問題，並自動過濾到當前用戶，參數如下：

• teamId（必需）：要過濾的團隊 ID。
• status（必需）：要過濾的狀態。

linear_get_workflow_states

用於獲取特定團隊的所有可用工作流狀態（狀態），參數如下：

• teamId（必需）：要獲取工作流狀態的團隊 ID。

linear_list_projects

可獲取所有可用項目及其 ID 的列表，還能可選地按團隊進行過濾，參數如下：

• teamId（可選）：按團隊過濾項目。
• limit（可選，默認值：10）：要返回的最大結果數。

💻 使用示例

在 Cursor 中使用

要在 Cursor 中使用此 MCP 服務器，可按以下步驟操作：

無需 Docker

⚠️ 重要提示 添加 Cursor 中的 MCP 服務器時，務必將 LINEAR_API_KEY 直接設置在命令中。這是確保服務器正確認證並與線性 API 交互的關鍵。如果忽略這一點，會導致身份驗證錯誤，服務器將無法正常工作。

示例：

env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js

1. 打開 Cursor 設置菜單。
2. 轉到“MCP 服務器”部分。
3. 點擊“添加 MCP 服務器”。
4. 輸入以下信息：
   • 名稱：linear - mcp - server
   • 運輸類型：命令
   • 命令：env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js
5. 點擊“保存”。
6. 您現在應該在 Cursor 的工具列表中看到線性工具。

使用 Docker

1. 打開 Cursor 設置菜單。
2. 轉到“MCP 服務器”部分。
3. 點擊“添加 MCP 服務器”。
4. 輸入以下信息：
   • 名稱：linear - mcp - server
   • 運輸類型：命令
   • 命令：docker exec -i mcp-linear-server node dist/server.js
5. 點擊“保存”。
6. 您現在應該在 Cursor 的工具列表中看到線性工具。

指示 Claude 使用

當指示 Claude 使用此 MCP 服務器時，您可以參考以下端點：

linear_create_issue

創建具有標題、描述、teamId、優先級和狀態的新線性問題。

linear_search_issues

按查詢、團隊、狀態、分配人、優先級和限制搜索線性問題。

linear_sprint_issues

獲取特定團隊中當前衝刺/迭代的所有問題。

linear_search_teams

按名稱搜索並檢索線性團隊。

linear_filter_sprint_issues

按狀態過濾特定團隊中的當前衝刺問題。

linear_get_workflow_states

獲取特定團隊的所有可用工作流狀態（狀態）。

linear_list_projects

獲取所有可用項目及其 ID 的列表，可選按團隊過濾。