Linear MCP Integration Server

基本能力

产品定位

Linear MCP集成服务器是一个中间件服务，旨在通过MCP协议桥接AI模型与Linear项目管理工具，实现自动化的问题跟踪和项目管理。

核心功能

1. 问题管理：
2. 创建新问题（linear_create_issue）
3. 搜索问题（linear_search_issues）
4. 获取当前迭代问题（linear_sprint_issues）

5. 过滤当前迭代问题（linear_filter_sprint_issues）

6. 团队与项目管理：

7. 搜索团队（linear_search_teams）
8. 获取工作流状态（linear_get_workflow_states）

9. 列出项目（linear_list_projects）

10. 技术特性：

11. 基于TypeScript和MCP SDK构建
12. 包含错误处理、速率限制和连接管理
13. 支持自动重连和心跳监控
14. 提供详细的调试日志

适用场景

1. AI辅助的项目管理自动化
2. 通过自然语言接口与Linear交互
3. 自动化问题跟踪和工作流管理
4. 团队项目状态监控和报告生成

工具列表

1. linear_create_issue：创建新Linear问题
2. linear_search_issues：灵活搜索Linear问题
3. linear_sprint_issues：获取当前迭代问题
4. linear_search_teams：搜索Linear团队
5. linear_filter_sprint_issues：按状态过滤当前迭代问题
6. linear_get_workflow_states：获取团队工作流状态
7. linear_list_projects：列出所有项目

常见问题解答

1. 认证失败：确保正确设置LINEAR_API_KEY环境变量
2. 连接问题：检查网络连接和Linear API可用性
3. 参数错误：验证必填参数（如teamId）是否提供
4. 速率限制：遵守Linear API的速率限制

使用教程

使用依赖

1. 安装Node.js和npm
2. 获取Linear API密钥（从Linear设置 > API部分）

安装教程

# 复制环境文件示例
cp .env.example .env

# 编辑.env文件添加API密钥
LINEAR_API_KEY=your_api_key_here

# 安装依赖
npm install

# 开发模式运行（带自动重载）
npm run dev

# 生产模式运行
npm start

Docker安装

# 构建并启动容器
docker-compose up -d

# 查看日志
docker-compose logs -f

调试方式

# 运行测试
npm run test

# 运行lint检查
npm run lint

# 检查MCP服务器
npm run inspect

许可证

None