关键词

Linear任务管理项目管理AI智能体工具集成

使用说明

项目简介

Linear MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器端应用，它充当 AI 智能体和 Linear 项目管理平台之间的桥梁。通过这个服务器，AI 智能体可以调用预设的工具，例如创建、查询、更新 Linear 中的 issue 和项目，从而实现自动化任务管理和项目协作。

主要功能点

  • Issue 管理: 创建、列表和更新 Linear 中的 issue。
  • 团队管理: 获取 Linear 工作空间中的团队列表。
  • 项目管理: 获取 Linear 项目列表。
  • 工具发现: 支持 MCP 协议的工具列表查询，允许客户端了解服务器提供的功能。
  • 错误处理: 提供完善的错误处理机制，当 API 密钥无效、缺少参数或 Linear API 错误时，能够返回清晰的错误信息。

安装步骤

  1. 安装 Node.js: 确保你的系统中已安装 Node.js (v16 或更高版本)。
  2. 获取 Linear API Key: 访问 Linear's Developer Settings 获取你的 Linear API Key。
  3. 运行 Linear MCP Server: 使用 'npx' 命令直接运行，并将你的 Linear API Key 作为环境变量传入： 
    LINEAR_API_KEY=你的API密钥 npx @ibraheem4/linear-mcp
    或者，你也可以先设置环境变量，再运行： 
    export LINEAR_API_KEY=你的API密钥
npx @ibraheem4/linear-mcp

服务器配置

要将 Linear MCP Server 集成到 MCP 客户端（如 Claude Desktop, VS Code Cline, Cursor），你需要配置客户端以连接到这个服务器。以下是针对不同客户端的配置示例，你只需要将配置信息添加到客户端的配置文件中即可。请注意，以下配置中的路径 '/path/to/linear-mcp/build/index.js' 是占位符，实际上 'npx @ibraheem4/linear-mcp' 已经可以直接运行，无需指定具体文件路径，因此 'args' 数组可以为空。 'command' 字段指定了运行服务器的命令，'env' 字段用于传递 Linear API Key。

为 Claude Desktop 配置 (MacOS)

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": [],
      "env": {
        "LINEAR_API_KEY": "你的API密钥"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

为 VS Code Extension (Cline) 配置

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": [],
      "env": {
        "LINEAR_API_KEY": "你的API密钥"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

为 Cursor 配置

对于 Cursor，可以直接使用 'npx' 命令启动服务器，无需特殊配置，Cursor 客户端会自动发现并连接到通过标准输入输出 (stdio) 通信的 MCP 服务器。

基本使用方法

配置完成后，你的 MCP 客户端应该能够检测到 Linear MCP Server 提供的工具。你可以通过客户端的界面或指令，调用以下工具来与 Linear 进行交互：

  • 'create_issue': 创建 issue
  • 'list_issues': 列出 issue
  • 'update_issue': 更新 issue
  • 'list_teams': 列出团队
  • 'list_projects': 列出项目
  • 'get_issue': 获取 issue 详情

工具的具体参数和使用方式，请参考仓库 README.md 文件中 "Available Tools" 部分的说明。

信息

分类

生产力应用

访问项目