🚀 Linear MCP 集成服务器

Linear MCP 集成服务器是一款用于连接并集成 Linear 工具的中间件。它借助模型上下文协议（Model Context Protocol），实现与 Claude 等 AI 模型的交互，提供了一系列功能，可用于创建、搜索和管理 Linear 项目中的问题与任务。

🚀 快速开始

若你想快速启动 Linear MCP 集成服务器，可参考以下不同方式的设置步骤。

开发者设置

环境配置

1. 下载并安装 Node.js 和 npm。
2. 创建 config 文件夹，并在其中添加 env 文件，内容如下：

   LINEAR_API_KEY=your_linear_api_key
   

3. 在项目根目录下创建 package.json 文件，内容如下：

   {
     "name": "linear-mcp-server",
     "version": "1.0.0",
     "scripts": {
       "start": "node dist/server.js"
     },
     "dependencies": {
       "@linear/sdk": "^2.0.0",
       "@modelcontextprotocol/sdk": "^1.0.0",
       "zod": "^1.0.0",
       "dotenv": "^16.3.1"
     }
   }
   

依赖安装

在项目根目录运行以下命令以安装所需依赖：

npm install

启动服务器

使用以下命令启动 MCP 服务器：

npm start

Docker 设置

镜像构建

创建 Dockerfile 文件，内容如下：

FROM node:16

WORKDIR /app

COPY package.json ./
COPY config/ ./

RUN npm install

CMD ["node", "dist/server.js"]

Compose 文件

创建 docker-compose.yml 文件，内容如下：

version: '3'
services:
  mcp-server:
    build: .
    ports:
      - "8080:8080"
    environment:
      - LINEAR_API_KEY=your_linear_api_key

启动服务

运行以下命令启动 Docker 服务：

docker-compose up --build

✨ 主要特性

工具端点

• linear_create_issue：可创建一个新的 Linear 问题，支持设置标题、描述、团队 ID、优先级和状态。
• linear_search_issues：能根据查询条件、团队、状态、分配人、优先级和限制数搜索 Linear 问题。
• linear_sprint_issues：获取指定团队当前冲刺或迭代中的所有问题。
• linear_search_teams：搜索并检索 Linear 团队，可按名称进行过滤。
• linear_filter_sprint_issues：根据状态过滤指定团队当前冲刺或迭代中的问题。
• linear_get_workflow_states：获取指定团队的所有可用工作流状态（即问题的状态）。
• linear_list_projects：获取所有项目的列表及其 ID，还可按团队进行筛选。

💻 使用示例

在 Cursor 中的使用

无 Docker 配置

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. 保存设置。

Docker 配置

1. 打开 Cursor 设置菜单。
2. 进入“MCP 服务器”部分。
3. 点击“添加 MCP 服务器”。
4. 填写以下信息：
   • 名称：linear-mcp-server
   • 运输类型：命令行
   • 命令：docker exec -i mcp-linear-server node dist/server.js
5. 保存设置。

指示 Claude 使用

Claude 可以通过以下 MCP 端点与 Linear 进行交互：

创建问题

使用 linear_create_issue 端点创建新问题：

POST /api/linear/create-issue
Content-Type: application/json

{
  "title": "问题标题",
  "description": "问题描述",
  "teamId": "团队ID",
  "priority": "优先级",
  "status": "状态"
}

搜索问题

通过 linear_search_issues 端点搜索问题：

GET /api/linear/search-issues?query=查询条件

示例响应

{
  "id": "12345",
  "title": "功能开发任务",
  "description": "实现新用户认证模块",
  "teamId": "001",
  "priority": "高",
  "status": "进行中"
}

🔧 技术细节

• 技术栈：基于 Node.js，使用 Linear SDK 和 MCP 协议实现。
• 错误处理：包括 API 超时保护、自动重连、详细日志记录和优雅关闭处理。
• 监控与维护：提供心跳监测以确保连接健康。

📄 许可证

文档未提及相关许可证信息。

⚠️ 重要提示

• 确保 LINEAR_API_KEY 设置正确且有效。
• 定期检查和更新依赖以获取最新功能和安全补丁。
• 在生产环境中，建议配置错误处理和日志记录机制。