线性 MCP 集成服务器
该服务器通过模型上下文协议 (MCP) 提供 Linear 集成功能。它允许 AI 模型与 Linear 进行交互，以进行问题跟踪和项目管理。
特征
服务器通过MCP接口提供以下工具：
linear_create_issue
使用以下参数创建一个新的线性问题：
title（必填）：问题标题teamId（必填）：创建问题的团队 IDdescription（可选）：问题描述（支持 markdown）priority（可选）：优先级（0-4）status（可选）：初始状态名称
线性搜索问题
通过灵活过滤来搜索线性问题：
query（可选）：标题/描述中要搜索的文本teamId（可选）：按团队过滤status（可选）：按状态过滤assigneeId（可选）：按受让人过滤priority（可选）：优先级（0-4）limit（可选，默认值：10）：返回的最大结果
linear_sprint_issues
获取当前冲刺/迭代中的所有问题：
teamId（必填）：获取冲刺问题的团队 ID
线性搜索团队
搜索并检索线性团队：
query（可选）：在团队名称中搜索的文本
linear_filter_sprint_issues
按状态过滤当前冲刺问题并自动过滤到当前用户：
teamId（必填）：获取冲刺问题的团队 IDstatus（必填）：要过滤的状态（例如“待发布产品”）
linear_get_workflow_states
获取团队所有可用的工作流程状态（状况）：
teamId（必需）：获取工作流状态的团队 ID
线性列表项目
获取所有可用项目及其 ID 的列表：
teamId（可选）：按团队过滤项目的团队 IDlimit（可选，默认值：50）：返回的最大项目数
Related MCP server: Linear MCP Server
开发人员设置
从 Linear 的设置 > API 部分获取 Linear API 密钥
复制环境示例：
cp .env.example .env修改文件
.env并更改 API 线性：LINEAR_API_KEY=votre_clé_api_linear_ici安装依赖项：
npm install启动服务器：
# Development mode with auto-reload npm run dev # Production mode npm start # Build TypeScript npm run build # Run linter npm run lint # Run tests npm run test # Inspect MCP server npm run inspect
如果项目是从 GitHub 克隆的，则需要进行 Docker 设置
您还可以使用 Docker 运行此应用程序：
确保您的系统上安装了 Docker 和 Docker Compose
按照上述说明，使用 Linear API 密钥创建一个
.env文件构建并启动容器：
# Build and start the container in detached mode docker-compose up -d # View logs docker-compose logs -f # Stop the container docker-compose down服务器将在容器内运行，并将自动重启，除非明确停止
使用 Docker（使用 docker-compose 的简化方法）
使用您的 Linear API 密钥创建一个
.env文件：LINEAR_API_KEY=your_linear_api_key_here创建
docker-compose.yml文件：version: '3.8' services: mcp-linear-server: image: madebynando/mcp-linear-server:latest container_name: mcp-linear-server restart: unless-stopped env_file: - .env volumes: - ./logs:/app/logs启动容器：
docker-compose up -d要配置 Cursor，请使用：
传输类型：命令
命令：docker exec -i mcp-linear-server node dist/server.js
Docker 开发
对于使用 Docker 进行开发：
技术细节
使用 TypeScript 和模型上下文协议 SDK 构建
使用 Linear SDK 进行 API 交互
包括错误处理、速率限制和连接管理
支持自动重新连接并可配置重试次数
实施心跳监控以监测连接健康状况
在调试模式下提供详细日志记录
错误处理
该服务器包括全面的错误处理：
API超时保护
连接丢失时自动重新连接尝试
带有时间戳的详细错误日志
优雅关机处理
连接健康状况的心跳监控
依赖项
@linear/sdk：线性 API 客户端@modelcontextprotocol/sdk：MCP 服务器实现zod：运行时类型检查和验证dotenv：环境变量管理TypeScript 和相关开发工具
有关依赖项的完整列表，请参阅package.json 。
在游标中使用
要在 Cursor 中使用此服务器，您可以将其添加为 MCP 服务器。
没有 Docker
**警告：**在 Cursor 中添加 MCP 服务器时，请确保在命令中直接设置
LINEAR_API_KEY。这对于服务器正确进行身份验证并与 Linear API 交互至关重要。否则将导致身份验证错误，服务器将无法正常运行。例子：
env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js
打开光标设置菜单
前往“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
打开光标设置菜单
前往“MCP 服务器”部分
点击“添加 MCP 服务器”
输入以下详细信息：
名称：linear-mcp-server
传输类型：命令
命令：docker exec -i mcp-linear-server node dist/server.js
点击“保存”
现在您应该可以在 Cursor 的工具列表中看到线性工具。
指导克劳德
当指示 Claude 使用此 MCP 服务器时，您可以参考以下端点：
创建一个具有标题、描述、团队 ID、优先级和状态的新线性问题。
通过查询、团队、状态、受让人、优先级和限制进行灵活过滤来搜索线性问题。
获取特定团队当前冲刺/迭代中的所有问题。
按名称搜索并检索线性团队。
根据特定团队的状态过滤当前的冲刺问题。
获取特定团队的所有可用工作流状态（状况）。
获取所有可用项目及其 ID 的列表，可选择按团队进行筛选。