🚀 线性 MCP 服务器

本项目是一个用于与线性（Linear）API交互的MCP服务器。它提供了一系列实用工具，借助Cline就能轻松管理线性平台上的问题、项目和团队，极大提升工作效率。

🚀 快速开始

本服务器可通过Cline实现对线性问题、项目和团队的管理。安装完成后，在Cline中输入相关命令即可使用。

✨ 主要特性

• 问题管理：能够创建、更新和删除问题，让问题处理更加高效。
• 项目管理：支持管理项目、里程碑和标签，助力项目有序推进。
• 团队协作：可查看团队成员信息及权限设置，促进团队协作顺畅。

📦 安装指南

1. 获取线性 API 令牌

您可以使用开发令牌或个人API密钥。

• 选项 1：开发令牌
  1. 访问线性：工作区设置 > API > OAuth 应用程序 > 创建或选择一个应用程序（例如："testapp"）。
  2. 转到https://your.linear.com/developer，找到您的新应用并复制其开发令牌。
• 选项 2：个人API密钥
  1. 访问线性：用户设置 > API访问 > 创建新的个人访问令牌。
  2. 复制生成的令牌，用于后续配置。

2. 设置Cline MCP服务器

编辑~/.config/lintrc.json文件（如果不存在则创建），添加以下内容：

{
  "development": {
    "api_key": "your-linear-api-token", // 替换为您的开发令牌或个人访问令牌
    "token_type": "bot" // 或保持为空，如果使用个人访问令牌
  }
}

3. 安装插件

在Cline中运行以下命令：

linx plugin add linear-mcp --url https://github.com/your-repository/linear-mcp.git

💻 使用示例

基础用法

安装完成后，在Cline中输入help查看可用命令：

$ linx help linear

输出将显示与线性集成相关的所有命令，例如：

• linear issue create：创建新问题
• linear project list：列出所有项目
• linear team members：获取团队成员列表

📚 详细文档

如需贡献代码，请按照以下步骤操作：

1. 克隆仓库：

git clone https://github.com/your-repository/linear-mcp.git
cd linear-mcp

2. 安装依赖：

npm install

3. 配置开发环境：
   • 复制.env.example到.env：

cp .env.example .env

- 更新`.env`文件中的配置，例如：

LINEAR_ACCESS_TOKEN=your-linear-api-token

4. 开发和测试：

npm run dev
# 或构建并启动服务器
npm run build && npm start

5. 提交代码前，请确保通过以下命令运行测试：

npm test

如需参与贡献，请访问项目仓库查看具体说明。