MCP 服务器

Linear MCP Integration Server

使人工智能模型能够与 Linear 交互，以进行问题跟踪和项目管理，通过诸如创建/搜索问题、管理冲刺和检索工作流状态等功能实现。

README

Linear MCP 集成服务器

该服务器通过模型上下文协议 (MCP) 提供 Linear 集成功能。它允许 AI 模型与 Linear 进行交互，以实现问题跟踪和项目管理。

功能特性

该服务器通过 MCP 接口提供以下工具：

linear_create_issue

创建新的 Linear issue，具有以下参数：

title (必需): Issue 标题
teamId (必需): 创建 issue 的团队 ID
description (可选): Issue 描述 (支持 markdown)
priority (可选): 优先级 (0-4)
status (可选): 初始状态名称

linear_search_issues

搜索 Linear issue，具有灵活的过滤功能：

query (可选): 在标题/描述中搜索的文本
teamId (可选): 按团队过滤
status (可选): 按状态过滤
assigneeId (可选): 按负责人过滤
priority (可选): 优先级 (0-4)
limit (可选, 默认: 10): 返回的最大结果数

linear_sprint_issues

获取当前 sprint/迭代中的所有 issue：

teamId (必需): 获取 sprint issue 的团队 ID

linear_search_teams

搜索和检索 Linear 团队：

query (可选): 在团队名称中搜索的文本

linear_filter_sprint_issues

按状态过滤当前 sprint issue，并自动过滤到当前用户：

teamId (必需): 获取 sprint issue 的团队 ID
status (必需): 要过滤的状态 (例如 "Pending Prod Release")

linear_get_workflow_states

获取团队的所有可用工作流状态（状态）：

teamId (必需): 获取工作流状态的团队 ID

linear_list_projects

获取可用项目及其 ID 的列表：

teamId (可选): 按团队过滤项目的团队 ID
limit (可选, 默认: 50): 返回的最大项目数

开发者设置

从 Linear 的设置 > API 部分获取您的 Linear API 密钥
复制示例环境变量文件：
```
cp .env.example .env
```
修改 .env 文件并添加您的 Linear API 密钥：
```
LINEAR_API_KEY=您的_linear_api_密钥_在此处
```
安装依赖项：
```
npm install
```

启动服务器：

# 开发模式，具有自动重新加载功能
npm run dev

# 生产模式
npm start

# 构建 TypeScript
npm run build

# 运行 linter
npm run lint

# 运行测试
npm run test

# 检查 MCP 服务器
npm run inspect

Docker 设置（如果项目从 GitHub 克隆）

您也可以使用 Docker 运行此应用程序：

确保您的系统上已安装 Docker 和 Docker Compose
创建一个 .env 文件，其中包含您的 Linear API 密钥，如上所述

构建并启动容器：

# 在分离模式下构建并启动容器
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止容器
docker-compose down

服务器将在容器内运行，并将自动重启，除非显式停止

使用 Docker（使用 docker-compose 的简化方法）

创建一个 .env 文件，其中包含您的 Linear API 密钥：
```
LINEAR_API_KEY=您的_linear_api_密钥_在此处
```

创建一个 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，请使用：
- 传输类型：command
- 命令：docker exec -i mcp-linear-server node dist/server.js

Docker 开发

对于使用 Docker 进行开发：

# 构建镜像
docker build -t mcp-linear-server .

# 在开发模式下运行，具有自动重新加载功能
docker run -it --rm \
  -v $(pwd):/app \
  -v /app/node_modules \
  --env-file .env \
  mcp-linear-server \
  npm run dev

技术细节

使用 TypeScript 和模型上下文协议 SDK 构建
使用 Linear SDK 进行 API 交互
包括错误处理、速率限制和连接管理
支持自动重新连接，具有可配置的重试次数
实施心跳监控以确保连接健康
在调试模式下提供详细的日志记录

错误处理

该服务器包括全面的错误处理：

API 超时保护
连接丢失时自动尝试重新连接
带有时间戳的详细错误日志记录
优雅的关闭处理
用于连接健康状况的心跳监控

依赖项

@linear/sdk: Linear API 客户端
@modelcontextprotocol/sdk: MCP 服务器实现
zod: 运行时类型检查和验证
dotenv: 环境变量管理
TypeScript 和相关的开发工具

有关依赖项的完整列表，请参见 package.json。

在 Cursor 中使用

要在 Cursor 中使用此服务器，您可以将其添加为 MCP 服务器。

不使用 Docker

警告确保在 Cursor 中添加 MCP 服务器时，直接在命令中设置 LINEAR_API_KEY。这对于服务器正确地进行身份验证并与 Linear API 交互至关重要。否则会导致身份验证错误，并且服务器将无法按预期运行。

示例：
env LINEAR_API_KEY=您的_linear_api_密钥 node /path/to/your/mcp-linear-server/dist/server.js

打开 Cursor 设置菜单
转到 "MCP Servers" 部分
点击 "Add MCP Server"
输入以下详细信息：
- Name: linear-mcp-server
- Transport type: command
- Command: env LINEAR_API_KEY=您的_linear_api_密钥 node /path/to/your/mcp-linear-server/dist/server.js
点击 "Save"
现在您应该在 Cursor 的工具列表中看到 Linear 工具。

使用 Docker

打开 Cursor 设置菜单
转到 "MCP Servers" 部分
点击 "Add MCP Server"
输入以下详细信息：
- Name: linear-mcp-server
- Transport type: command
- Command: docker exec -i mcp-linear-server node dist/server.js
点击 "Save"
现在您应该在 Cursor 的工具列表中看到 Linear 工具。