线性 MCP 服务器使用说明

安装依赖项

npm install

配置 Linear API 密钥在 .env 中：

LINEAR_API_KEY=your_api_key_here

构建服务器

npm run build

开发时自动重建：

npm run watch

许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着你可以自由使用、修改和分发软件，前提是符合 MIT 许可证的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。

以下是所有内容的完整中文翻译：

线性 MCP 服务器说明

这是一个用于与 Linear 平台交互的 MCP（模块化命令处理器）服务器。它允许通过命令行或集成工具执行各种任务，如创建、更新和查询问题、管理团队和项目等。

安装依赖项

运行以下命令安装所需的包：

npm install

配置 API 密钥

将 Linear 提供的 API 密钥添加到 .env 文件中：

LINEAR_API_KEY=your_api_key_here

构建服务器

构建服务器以开始使用：

npm run build

开发时，可以使用以下命令实现自动重建：

npm run watch

使用说明

创建新问题

要创建一个新的问题，请使用 linear_create_issue 命令并指定必要的参数。

例如：

linear_create_issue --title "新的认证系统故障" --description "报告身份验证页面上的错误。"

更新现有问题

要更新现有问题的属性（如优先级或状态），请使用 linear_update_issue：

例如，将问题 FRONT-123 的优先级设置为“紧急”：

linear_update_issue --issue-id FRONT-123 --priority 紧急

添加评论

要向问题添加评论，请使用 linear_add_comment 命令并指定问题 ID 和评论内容。

例如，将以下内容添加到问题 LOGIN-456：

linear_add_comment --issue-id LOGIN-456 "已识别根本原因：密码字段未正确加密。"

搜索问题

使用 linear_search_issues 命令搜索符合条件的问题：

例如，查找所有状态为“进行中”的前端任务：

linear_search_issues --status 进行中 --label 前端

获取项目信息

要获取特定项目的详细信息，请使用 linear_get_project 并指定项目 ID。

例如，获取项目 MOBILE-APP 的信息：

linear_get_project --project-id MOBILE-APP

团队管理

获取团队成员列表

要列出某个团队的成员，请使用 linear_get_team_members：

例如，获取 Frontend 团队的成员：

linear_get_team_members --team-id frontend-team

获取用户所属团队

要查看当前用户所属的所有团队，请运行 linear_get_user_teams：

linear_get_user_teams

标签管理

创建新标签

使用 linear_create_tag 命令创建新的问题标签。

例如，创建“ backlog”标签：

linear_create_tag --name backlog

更新标签属性

要更新现有标签的属性，请使用 linear_update_tag：

例如，将“UI 重构”标签的颜色更改为蓝色：

linear_update_tag --tag-id ui-refactor --color 蓝色

开发说明

安装依赖项

运行以下命令安装所需的包：

npm install

配置 API 密钥

将 Linear 提供的 API 密钥添加到 .env 文件中：

LINEAR_API_KEY=your_api_key_here

构建服务器

构建服务器以开始使用：

npm run build

开发时，可以使用以下命令实现自动重建：

npm run watch

示例

创建问题并添加评论

1. 使用 linear_create_issue 创建一个问题：

   linear_create_issue --title "新的认证系统故障" --description "报告身份验证页面上的错误。"
   

2. 使用 linear_add_comment 添加评论到该问题：

   linear_add_comment --issue-id 新的认证系统故障 --comment "已识别根本原因：密码字段未正确加密。"
   

搜索和过滤问题

使用以下命令搜索特定类型的问题并应用筛选器：

linear_search_issues --status 已解决 --label 前端

项目结构

• src/：包含所有源代码文件。
• commands/：包含定义的命令模块。
• config/：包含配置文件和环境变量。
• index.js：应用程序入口点。

常见问题

如何获取 API 密钥？

访问 Linear 平台的“用户设置”页面，找到“开发者工具”部分，即可获取 API 密钥。

支持哪些命令？

当前版本支持以下命令：

• linear_create_issue
• linear_update_issue
• linear_add_comment
• linear_search_issues
• linear_get_project
• linear_get_team_members

更多命令正在开发中。

贡献指南

欢迎社区贡献！请参考项目仓库中的 CONTRIBUTING.md 文件了解如何参与开发。

许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着你可以自由使用、修改和分发软件，前提是符合 MIT 许可证的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。