🚀 Linear MCP 服务器
Linear MCP 服务器是一款用于与 Linear 平台进行交互的实用工具。它具备丰富的功能，可实现对问题、周期、项目等相关实体的创建、更新和检索操作。
🚀 快速开始
Linear MCP 服务器为开发者提供了便捷的方式与 Linear 平台交互。以下是使用该服务器的基本步骤。
📦 安装指南
先决条件
- Node.js（版本 14 或更高）
- npm（版本 6 或更高）
下载代码
git clone [repository-url]
cd linear-mcp-server
安装依赖项
npm install
🔧 配置
创建一个 .env 文件，并添加以下内容：
NEXT_PUBLIC_LINEAR_CLIENT_ID=your_client_id
NEXT_PUBLIC_LINEAR_CLIENT_SECRET=your_client_secret
NEXT_PUBLIC_LINEAR_REDIRECT_URI=your_redirect_uri
NEXT_PUBLIC_LINEAR_ENVIRONMENT=production
✨ 主要特性
问题管理
- 创建问题
- 更新问题
- 获取单个问题
- 获取所有问题
周期管理
- 创建周期
- 更新周期
- 获取单个周期
- 获取所有周期
项目管理
- 创建项目
- 更新项目
- 获取单个项目
- 获取所有项目
💻 使用示例
基础用法
# 创建问题
npm run create-issue -- --title "问题标题" --description "问题描述" --assigneeId user-id --stateId state-id --priority 0 --estimate 1 --cycleId cycle-id --projectId project-id --labelIds label-id,label-id2
# 更新问题
npm run update-issue -- --issueId issue-id --title "新标题" --description "新描述" --assigneeId user-id --stateId state-id --priority 0 --estimate 1 --cycleId cycle-id --projectId project-id --labelIds label-id,label-id2
📚 详细文档
调试
如果在使用过程中遇到问题，请参考以下调试步骤：
- 检查环境变量是否正确设置
- 确保 Linear API 正常运行（可访问 status.linear.app）
- 查看服务器日志以获取更多错误信息
开发
安装依赖项
npm install
启动开发服务器
npm run dev
🔧 技术细节
在使用 Linear MCP 服务器时，需要注意以下安全事项：
⚠️ 重要提示
- 不要提交敏感令牌：
.env文件和其他包含令牌的文件应排除在版本控制之外。- 使用环境变量：始终在 MCP 配置中使用环境变量，而不是硬编码令牌。
- 限制权限：创建 Linear OAuth 应用程序时，请仅授予所需的权限。
- 定期轮换令牌：定期生成新令牌并更新配置。
📄 许可证
本项目采用 MIT 许可证。