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