MCP Server Linearapp

🚀 线性 MCP 服务器使用说明

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

🚀 快速开始

安装依赖项

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

npm install

配置 API 密钥

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

LINEAR_API_KEY=your_api_key_here

构建服务器

构建服务器以开始使用：

npm run build

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

npm run watch

✨ 主要特性

本服务器支持多种与 Linear 平台交互的操作，涵盖问题的创建、更新、评论添加、搜索，项目信息获取，团队成员管理以及标签管理等功能。

💻 使用示例

基础用法

创建新问题

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

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

更新现有问题

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

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

添加评论

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

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

搜索问题

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

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

获取项目信息

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

linear_get_project --project-id MOBILE-APP

团队管理

获取团队成员列表

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

linear_get_team_members --team-id frontend-team

获取用户所属团队

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

linear_get_user_teams

标签管理

创建新标签

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

linear_create_tag --name backlog

更新标签属性

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

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

高级用法

创建问题并添加评论

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 文件。