MCP Linear Server

🚀 线性 MCP 集成服务器

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

🚀 快速开始

此服务器可通过以下步骤进行开发设置和部署：

开发设置

1. 克隆仓库。
2. 安装依赖项：

   npm install
   

3. 创建 .env 文件并添加 Linear API 密钥：

   LINEAR_API_KEY=your_api_key_here
   

4. 运行服务器：

   npm run dev
   

Smithery 部署

此服务器可部署于 Smithery.ai，使用提供的配置文件。

先决条件

• Smithery 账户
• Linear API 密钥

部署步骤

1. 添加此仓库到 Smithery 或 claim 已有服务。
2. 访问部署选项卡（仅限认证所有者）。
3. 配置部署参数，设置 Linear API 密钥。
4. 发布服务器。

本地测试

1. 构建 Docker 镜像：

   docker build -t linear-mcp-server .
   

2. 运行容器并设置环境变量：

   docker run -e LINEAR_API_KEY=your_api_key_here linear-mcp-server
   

3. 或使用 MCP 检查工具：

   npm run inspect
   

✨ 主要特性

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

linear_create_issue

创建新的 Linear 问题，支持以下参数：

• title（必需）：问题标题
• teamId（必需）：要创建问题的团队 ID
• description（可选）：问题描述
• labels（可选）：问题标签列表

linear_list_issues

列出指定团队的所有问题，支持以下参数：

• teamId（必需）：目标团队 ID
• filter（可选）：过滤条件（如状态、标签等）

linear_get_issue

获取单个问题的详细信息，支持以下参数：

• teamId（必需）：目标团队 ID
• issueId（必需）：要获取的问题 ID

linear_update_issue

更新现有问题的信息，支持以下参数：

• teamId（必需）：目标团队 ID
• issueId（必需）：要更新的问题 ID
• title（可选）：新标题
• description（可选）：新描述
• labels（可选）：新标签列表

linear_delete_issue

删除指定问题，支持以下参数：

• teamId（必需）：目标团队 ID
• issueId（必需）：要删除的问题 ID

🔧 技术细节

项目架构

• 使用 TypeScript 编写，确保代码的强类型和可维护性。
• 基于 Linear SDK 构建，提供对 Linear API 的封装和支持。
• 配合 MCP 协议，实现与 AI 模型的无缝交互。

核心功能

• 问题创建、读取、更新和删除操作。
• 团队间的问题隔离与权限控制。
• 支持自定义过滤器和排序逻辑。
• 提供详细的错误处理和日志记录。

📈 性能与可靠性

缓存系统

• 使用内存缓存加速频繁访问的操作。
• 设置合理的过期时间，平衡一致性和性能。
• 支持手动刷新缓存以确保数据一致性。

错误处理

• 全面的错误捕捉和处理机制。
• 友好的错误信息反馈。
• 自动重试策略应对临时性故障。

性能优化

• 线程池与连接池管理。
• 并发请求的负载均衡。
• 效率优化的数据访问模式。
• 分页机制处理大数量集。

📦 依赖项

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

完整的依赖列表请查看 package.json。

📚 详细文档

配置文件

Dockerfile

定义了服务器的构建流程：

• 使用 Node.js 18 Alpine 作为基础镜像。
• 安装依赖项并构建 TypeScript 代码。
• 设置运行命令。

smithery.yaml

配置服务器启动参数：

• 指定运行命令。
• 定义所需配置参数（Linear API 密钥）。
• 管理环境变量。