🚀 线性 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 的列表，可选按团队过滤。