Linear MCP Server

基本能力

产品定位

Linear MCP Server 是一个中间件服务，旨在为开发者和团队提供一个标准化的接口来与 Linear 的问题跟踪系统进行交互。

核心功能

• 创建新问题和子问题，支持标签
• 检索 Linear 项目列表
• 检索项目更新
• 创建带有健康状态的新项目更新
• 更新现有问题的所有字段
• 删除问题并进行验证
• 使用 'me' 关键字自分配问题
• 高级搜索功能，支持 Linear 的强大过滤能力
• 按周期过滤问题（当前、下一个、上一个或特定 UUID/编号的周期）
• 添加支持 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 为你的 API token

使用教程

使用依赖

• 安装 Bun 运行时 (v1.0.0 或更高版本)
• 获取 Linear API 访问权限

安装教程

1. 克隆仓库:

git clone [repository-url]
cd linear-mcp

1. 安装依赖并构建:

bun install
bun run build

1. 配置 MCP 服务器:
2. 编辑相应配置文件（根据操作系统不同路径不同）
3. 在 mcpServers 对象下添加配置:

{
  "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 开源许可条款。