Linear MCP Server

基本能力

产品定位

Linear MCP Server 是一个用于与 Linear 问题跟踪系统交互的中间件服务，提供标准化的接口来管理问题、项目和更新。

核心功能

• 创建新问题和子问题，支持标签
• 检索 Linear 项目列表
• 检索项目更新
• 创建带有健康状态的新项目更新
• 更新现有问题的所有字段
• 删除问题并进行验证
• 使用 'me' 关键字自分配问题
• 使用 Linear 强大的过滤功能进行高级搜索
• 按周期过滤问题（当前、下一个、上一个或特定周期）
• 添加支持 Markdown 的评论
• 按 ID 或键查询问题，可选包含关系
• 使用自定义查询搜索问题，带有增强的元数据
• 使用 Linear 官方 SDK 进行类型安全操作
• 全面的错误处理
• 速率限制处理
• 数据清理和转换
• 父子关系跟踪与团队继承
• 标签管理和同步

适用场景

• 开发团队的问题跟踪和管理
• 项目状态更新和报告
• 自动化工作流程集成
• 与其他工具的系统集成

工具列表

1. create_issue: 创建新的 Linear 问题或子问题
2. update_issue: 更新现有的 Linear 问题
3. get_issue: 获取特定 Linear 问题的详细信息
4. search_issues: 使用查询字符串和高级过滤器搜索 Linear 问题
5. get_teams: 获取 Linear 团队列表
6. delete_issue: 删除现有的 Linear 问题
7. create_comment: 在 Linear 问题上创建新评论
8. get_projects: 获取 Linear 项目列表
9. get_project_updates: 获取给定项目 ID 的项目更新
10. create_project_update: 为 Linear 项目创建新更新

常见问题解答

• 需要 Bun 运行时 (v1.0.0 或更高版本)
• 需要 Linear 账户和 API 访问权限
• 配置环境变量 LINEAR_API_KEY
• 详细的错误处理和日志记录

使用教程

使用依赖

• 安装 Bun 运行时 (v1.0.0 或更高版本)
• 获取 Linear API 密钥

安装教程

1. 克隆仓库:

git clone [repository-url]
cd linear-mcp

1. 安装依赖并构建:

bun install
bun run build

1. 配置 MCP 服务器: 编辑适当的配置文件并添加配置:

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/absolute/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_api_key"
      }
    }
  }
}

1. 重启 MCP 服务器

调试方式

运行开发服务器:

bun run dev

构建项目:

bun run build

许可证

该项目遵循 MIT 开源许可条款。