linear-mcp

🚀 Linear MCP 服务器

这是一个用于通过 Cline 管理 Linear API 的 MCP 服务器。该服务器提供了一组工具，可用于管理 Linear 的问题、项目和团队，助力用户高效处理相关事务。

🚀 快速开始

你可以按照以下步骤快速搭建并使用 Linear MCP 服务器。

📦 安装指南

1. 环境搭建

• 克隆仓库。
• 安装依赖：

npm install

• 复制 .env.example 到 .env：

cp .env.example .env

2. 认证方法

服务器支持两种认证方式：

API Key（推荐）

1. 进入 Linear 设置。
2. 点击“安全与访问”部分。
3. 找到“个人 API 密钥”部分。
4. 点击“新建 API 密钥”。
5. 为密钥添加一个描述性标签（例如：“Cline MCP”）。
6. 复制生成的令牌。
7. 将令牌添加到 .env 文件中：

LINEAR_API_KEY=your_api_key

OAuth 流程（备用）未实现

1. 在 https://linear.app/settings/api/applications 创建一个新的 OAuth 应用。
2. 配置 OAuth 环境变量在 .env 中：

LINEAR_CLIENT_ID=你的_oauth_client_id
LINEAR_CLIENT_SECRET=你的_oauth_client_secret
LINEAR_REDIRECT_URI=http://localhost:3000/callback

3. 运行服务器

• 构建服务器：

npm run build

• 启动服务器：

npm start

4. Cline 集成

1. 打开你的 Cline MCP 设置文件：
   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. 添加 Linear MCP 服务器配置：

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "你的个人访问令牌"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

✨ 主要特性

已支持的操作

• 问题管理：
  • ✅ 创建带有完整信息的问题。
  • ✅ 更新现有问题的状态、标题和描述。
  • ✅ 删除问题。
  • ✅ 获取所有问题的列表。
  • ✅ 根据筛选条件获取问题。
• 项目管理：
  • ✅ 创建新项目。
  • ✅ 更新现有项目的名称和描述。
  • ✅ 删除项目。
  • ✅ 获取所有项目的信息。
• 团队管理：
  • ✅ 添加新的团队成员。
  • ✅ 更新团队成员的角色和权限。
  • ✅ 移除团队成员。
  • ✅ 获取所有团队成员的列表。

开发中功能

• 问题评论：
  • ✅ 创建问题评论。
  • ✅ 更新现有评论的内容。
  • ✅ 删除评论。
  • ✅ 获取所有评论的列表。
• 标签管理：
  • ✅ 添加新的标签。
  • ✅ 更新现有标签的颜色和名称。
  • ✅ 删除标签。
  • ✅ 获取所有标签的列表。

💻 使用示例

开发指令

npm install  # 安装依赖
npm run build  # 构建服务器
npm start  # 启动服务器

接口示例

创建问题

POST /api/issues
{
  "title": "新问题",
  "description": "这是一个新的测试问题。",
  "projectId": "12345"
}

更新问题状态

PUT /api/issues/12345
{
  "status": "已完成"
}

获取所有项目

GET http://localhost:3000/api/projects

返回结果示例

{
  "data": {
    "projects": [
      {
        "_id": "12345",
        "name": "项目名称",
        "description": "项目描述"
      }
    ]
  }
}

错误处理

• 400 Bad Request：请求格式错误或缺少必填参数。
• 401 Unauthorized：认证失败。
• 404 Not Found：资源未找到。
• 500 Internal Server Error：服务器内部错误。