🚀 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 许可证。