Linear MCP Server测评：连接AI与项目管理的桥梁

# 检查Node.js是否安装
node --version
npm --version

# 如未安装，从 https://nodejs.org/ 下载安装包

# 通过npm全局安装（如项目仍可用）
npm install -g linear-mcp-server

# 或从源码安装
git clone <repository-url>
cd linear-mcp-server
npm install
npm run build

LINEAR_API_KEY=your_linear_api_key_here

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

brew install node

# 克隆项目仓库
git clone <repository-url>
cd linear-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

# 设置环境变量
export LINEAR_API_KEY="your_linear_api_key_here"

# 或添加到 ~/.zshrc 或 ~/.bash_profile
echo 'export LINEAR_API_KEY="your_linear_api_key_here"' >> ~/.zshrc

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# CentOS/RHEL
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs

# 获取项目代码
git clone <repository-url>
cd linear-mcp-server

# 安装和构建
npm install
npm run build

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp-server/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

// linear_bug_workflow.js
// 自动化Bug上报与处理工作流

class LinearBugWorkflow {
  constructor() {
    this.teamId = "your-team-id"; // 需要在Linear中获取实际团队ID
  }

  /**
   * 创建Bug报告
   */
  async createBugReport(bugInfo) {
    const { title, description, priority, assigneeId } = bugInfo;
    
    // 调用MCP工具创建问题
    const issueResult = await use_mcp_tool({
      server_name: "linear",
      tool_name: "linear_create_issue",
      arguments: {
        teamId: this.teamId,
        title: title,
        description: description,
        priority: priority || "MEDIUM",
        assigneeId: assigneeId || null
      }
    });

    return issueResult;
  }

  /**
   * 搜索相关问题
   */
  async searchSimilarIssues(keywords) {
    const searchResult = await use_mcp_tool({
      server_name: "linear",
      tool_name: "linear_search_issues",
      arguments: {
        query: keywords,
        teamIds: [this.teamId],
        first: 5
      }
    });

    return searchResult;
  }

  /**
   * 更新问题状态
   */
  async updateIssueStatus(issueId, status) {
    const updateResult = await use_mcp_tool({
      server_name: "linear",
      tool_name: "linear_update_issue",
      arguments: {
        issueId: issueId,
        stateId: status
      }
    });

    return updateResult;
  }

  /**
   * 添加问题评论
   */
  async addIssueComment(issueId, comment) {
    const commentResult = await use_mcp_tool({
      server_name: "linear",
      tool_name: "linear_add_comment",
      arguments: {
        issueId: issueId,
        commentText: comment
      }
    });

    return commentResult;
  }

  /**
   * 完整Bug处理流程
   */
  async handleBugWorkflow(bugInfo) {
    try {
      console.log("开始处理Bug上报流程...");

      // 1. 搜索类似问题避免重复
      console.log("搜索类似问题...");
      const similarIssues = await this.searchSimilarIssues(bugInfo.title);
      
      if (similarIssues.issues.nodes.length > 0) {
        console.log(`找到 ${similarIssues.issues.nodes.length} 个类似问题`);
        // 可根据实际情况决定是否继续创建新问题
      }

      // 2. 创建Bug报告
      console.log("创建新的Bug报告...");
      const newIssue = await this.createBugReport(bugInfo);
      console.log(`问题创建成功: ${newIssue.issue.identifier}`);

      // 3. 添加初始评论
      const initialComment = `该问题由AI助手在代码审查中发现并自动创建。
      问题详情: ${bugInfo.description}
      发现时间: ${new Date().toISOString()}`;
      
      await this.addIssueComment(newIssue.issue.id, initialComment);
      console.log("初始评论添加完成");

      return {
        success: true,
        issueId: newIssue.issue.id,
        issueIdentifier: newIssue.issue.identifier,
        similarIssuesFound: similarIssues.issues.nodes.length
      };

    } catch (error) {
      console.error("Bug处理流程失败:", error);
      return {
        success: false,
        error: error.message
      };
    }
  }
}

// 使用示例
async function main() {
  const workflow = new LinearBugWorkflow();
  
  const bugInfo = {
    title: "用户登录时出现空指针异常",
    description: `在用户登录流程中，当用户名为空时系统抛出空指针异常。
    
    重现步骤:
    1. 访问登录页面
    2. 不输入用户名直接点击登录
    3. 观察控制台错误日志
    
    预期行为:
    应该显示"用户名不能为空"的验证错误消息
    
    相关文件:
    - src/auth/LoginService.java
    - src/web/LoginController.java`,
    priority: "HIGH",
    assigneeId: "user-id-123" // 实际的用户ID
  };

  const result = await workflow.handleBugWorkflow(bugInfo);
  console.log("流程执行结果:", result);
}

// 在AI助手环境中，可以直接调用工作流
// 根据实际环境调整调用方式