🚀 线性 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
- 打开 Cursor 设置菜单。
- 转到“MCP 服务器”部分。
- 点击“添加 MCP 服务器”。
- 输入以下信息：
- 名称：linear - mcp - server
- 运输类型：命令
- 命令：env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js
- 点击“保存”。
- 您现在应该在 Cursor 的工具列表中看到线性工具。
使用 Docker
- 打开 Cursor 设置菜单。
- 转到“MCP 服务器”部分。
- 点击“添加 MCP 服务器”。
- 输入以下信息：
- 名称：linear - mcp - server
- 运输类型：命令
- 命令：docker exec -i mcp-linear-server node dist/server.js
- 点击“保存”。
- 您现在应该在 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 的列表，可选按团队过滤。