🚀 Linear MCP 集成服务器
Linear MCP 集成服务器是一款用于连接并集成 Linear 工具的中间件。它借助模型上下文协议（Model Context Protocol），实现与 Claude 等 AI 模型的交互，提供了一系列功能，可用于创建、搜索和管理 Linear 项目中的问题与任务。
🚀 快速开始
若你想快速启动 Linear MCP 集成服务器，可参考以下不同方式的设置步骤。
开发者设置
环境配置
- 下载并安装 Node.js 和 npm。
- 创建
config文件夹，并在其中添加env文件，内容如下：LINEAR_API_KEY=your_linear_api_key - 在项目根目录下创建
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 配置
- 打开 Cursor 设置菜单。
- 进入“MCP 服务器”部分。
- 点击“添加 MCP 服务器”。
- 填写以下信息：
- 名称：linear-mcp-server
- 运输类型：命令行
- 命令：
env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js
- 保存设置。
Docker 配置
- 打开 Cursor 设置菜单。
- 进入“MCP 服务器”部分。
- 点击“添加 MCP 服务器”。
- 填写以下信息：
- 名称：linear-mcp-server
- 运输类型：命令行
- 命令：
docker exec -i mcp-linear-server node dist/server.js
- 保存设置。
指示 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 设置正确且有效。
- 定期检查和更新依赖以获取最新功能和安全补丁。
- 在生产环境中，建议配置错误处理和日志记录机制。