Scan to join WeChat groupREADME
🚀 线性 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 蓝色
高级用法
创建问题并添加评论
- 使用
linear_create_issue创建一个问题：
linear_create_issue --title "新的认证系统故障" --description "报告身份验证页面上的错误。"
- 使用
linear_add_comment添加评论到该问题：
linear_add_comment --issue-id 新的认证系统故障 --comment "已识别根本原因：密码字段未正确加密。"
搜索和过滤问题
使用以下命令搜索特定类型的问题并应用筛选器：
linear_search_issues --status 已解决 --label 前端
📚 详细文档
项目结构
src/：包含所有源代码文件。commands/：包含定义的命令模块。config/：包含配置文件和环境变量。index.js：应用程序入口点。
常见问题
如何获取 API 密钥？
访问 Linear 平台的“用户设置”页面，找到“开发者工具”部分，即可获取 API 密钥。
支持哪些命令？
当前版本支持以下命令：
linear_create_issuelinear_update_issuelinear_add_commentlinear_search_issueslinear_get_projectlinear_get_team_members
更多命令正在开发中。
贡献指南
欢迎社区贡献！请参考项目仓库中的 CONTRIBUTING.md 文件了解如何参与开发。
📄 许可证
此 MCP 服务器根据 MIT 许可证发布。这意味着你可以自由使用、修改和分发软件，前提是符合 MIT 许可证的条款和条件。有关详细信息，请参阅项目仓库中的 LICENSE 文件。