← 返回目录
L

Linear MCP Server

社区
通过 MCP 服务器与 Linear API 交互,管理问题、项目和团队。
GitHub 源仓库 ↗
★ 134 Stars 分类 · 团队协作 热门 源版本 023ac902e0f5
35FMRS · D
可靠性
8/20
安全与权限
5/20
维护活跃度
7/20
文档质量
8/20
安装易用性
7/20

该服务器提供了基本的 Linear 集成,支持问题、项目和团队管理。它注重富文本描述处理,并具有批量操作能力。但 OAuth 尚未实现,部分功能仍在开发中。适合使用 Cline 并需要直接 API 访问的用户。

查看 FMRS 评分方法 →

这是一个为 Cline 设计的私有 MCP 服务器,用于访问 Linear 的 API。它提供了一系列工具来管理 Linear 的问题(issues)、项目和团队。支持 API Key 认证(推荐),OAuth 流程尚未实现。服务器实现了对 Linear 富文本描述字段(documentContent)的支持,确保项目描述完整显示。

工具能力

create_issue
创建问题,支持标题、描述、团队、项目等完整字段。
update_issue
更新现有问题(优先级、描述等)。
delete_issue
删除问题(支持单个或批量删除)。
search_issues
搜索问题并支持过滤。
create_comment
创建评论或线程评论。
get_project
获取项目信息,包含富文本描述。
search_projects
搜索项目,包含富文本描述。
create_project
创建项目并关联问题。
get_team
获取团队信息(包含状态和工作流详情)。
bulk_create_issues
批量创建问题。
bulk_delete_issues
批量删除问题。

安装接入

  1. 克隆仓库
  2. 运行 npm install
  3. 复制 .env.example.env
  4. 在 Linear 设置中创建个人 API 密钥,并添加到 .env 文件中的 LINEAR_API_KEY
  5. 运行 npm run buildnpm start
  6. 在 Cline 的 MCP 设置文件中添加服务器配置(见 install_config)
claude_desktop_config.json
{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_personal_access_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

选型与风险

适合谁

  • 使用 Cline 且需要访问 Linear 的开发者
  • 希望将 Linear 问题管理与 AI 编程助手集成的团队

不适合谁

  • 需要 OAuth 认证的用户(尚未实现)
  • 需要高级搜索过滤或分页支持的用户(开发中)
  • 非 Cline 用户(README 主要围绕 Cline 集成)

所需权限

  • 需要有效的 Linear API 密钥(个人访问令牌)
  • API 密钥权限与创建密钥的用户相同,可能具有创建、更新和删除问题的权限

风险与副作用

  • API 密钥泄露可能导致未授权访问
  • 批量操作可能意外删除或修改大量问题
  • 服务器为私有项目,可能存在未解决的 bug 或安全问题

常见排障

  1. 检查 API 密钥是否有效且未过期
  2. 确保 `.env` 文件正确配置且包含 `LINEAR_API_KEY`
  3. 验证构建是否成功:运行 `npm run build`
  4. 检查 Cline 配置中的路径是否正确指向 `build/index.js`
  5. 查看服务器日志以获取错误信息

使用场景

在 AI 助手(如 Cline)中管理和查阅 Linear 问题
自动化创建、更新和删除问题
获取项目富文本描述
批量操作问题

支持客户端

Claude Desktop完整支持