关键词

LinearIssue Tracking项目管理LLM集成工作流自动化

Linear MCP Server 使用说明

项目简介

Linear MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，它充当大型语言模型 (LLM) 与 Linear 项目管理工具之间的桥梁。通过此服务器，LLM 客户端可以安全、便捷地访问和操作 Linear 中的 issue（问题）、项目、团队和用户信息，从而实现智能化的项目管理和工作流自动化。

主要功能点

  • 问题管理: 创建、更新和搜索 Linear issue，包括设置标题、描述、优先级、状态、指派人员和标签。
  • 评论互动: 在 Linear issue 中添加评论，支持 Markdown 格式，方便 LLM 记录和同步讨论内容。
  • 用户信息: 获取当前用户和组织的信息，包括用户所属团队和组织结构，为上下文理解提供基础数据。
  • 资源访问: 通过标准化的 URI 访问 Linear 中的各种资源，如 issue 详情、团队 issue 列表和用户指派的 issue 列表。
  • 工具集成: 提供一系列预定义的工具 (Tools)，例如 'linear_create_issue', 'linear_update_issue', 'linear_search_issues' 等，允许 LLM 通过调用这些工具执行具体操作。
  • Prompt 模板: 内置 Prompt 模板，指导 LLM 如何有效地与 Linear MCP Server 交互，并提供最佳实践建议。

安装步骤

  1. 获取 Linear API Key: 访问 https://linear.app/YOUR-TEAM/settings/api (请将 'YOUR-TEAM' 替换为您的 Linear 团队名称)，创建或获取一个 Linear API Key。
  2. 配置 Claude Desktop (或其他 MCP 客户端): 如果使用 Claude Desktop 作为 MCP 客户端，需要修改配置文件 'claude_desktop_config.json' (MacOS 路径: '~/Library/Application Support/Claude/claude_desktop_config.json')，添加 Linear MCP Server 的配置信息。

服务器配置

以下 JSON 配置信息用于告知 MCP 客户端如何启动和连接 Linear MCP Server。请将此配置添加到您的 MCP 客户端配置中 (例如 Claude Desktop 的 'claude_desktop_config.json')。

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear"
      ],
      "env": {
        "LINEAR_API_KEY": "YOUR_LINEAR_API_KEY_HERE"  // 将 YOUR_LINEAR_API_KEY_HERE 替换为您在步骤1中获取的 Linear API Key
      }
    }
  }
}

配置参数说明:

  • '"linear"': 服务器名称，可以自定义，用于在 MCP 客户端中标识此服务器。
  • '"command": "npx"': 启动服务器的命令，'npx' 用于执行 Node.js 包。
  • '"args": ["-y", "@modelcontextprotocol/server-linear"]': 'npx' 命令的参数，'-y' 表示自动确认安装包，'@modelcontextprotocol/server-linear' 是 Linear MCP Server 的 npm 包名称。
  • '"env": { "LINEAR_API_KEY": "YOUR_LINEAR_API_KEY_HERE" }': 设置环境变量，'LINEAR_API_KEY' 用于存储您的 Linear API Key，请务必将 'YOUR_LINEAR_API_KEY_HERE' 替换为您实际的 API Key。

注意: '@modelcontextprotocol/server-linear' 是此仓库的 npm 包名 (假设已发布，如果未发布，则需要根据实际情况修改启动方式，例如使用 'node index.js' 并确保在项目根目录下执行)。 请根据实际的 npm 包发布情况或者本地运行方式调整 '"command"' 和 '"args"' 配置。

基本使用方法

配置完成后，您的 MCP 客户端 (如 Claude Desktop) 应该能够识别并连接到 Linear MCP Server。您可以使用自然语言指令，通过 MCP 客户端与 Linear 进行交互。

使用示例 (通过 Claude Desktop):

  1. 查询高优先级 issue: 在 Claude Desktop 中输入类似 "Show me all my high-priority issues in Linear" 的指令，服务器将调用 'linear_search_issues' 工具或访问 'linear-user:///{userId}/assigned' 资源来检索并返回结果。
  2. 创建 bug 报告: 输入类似 "Based on our conversation, create a bug report for the authentication system in Linear" 的指令，服务器将调用 'linear_create_issue' 工具，根据上下文信息创建新的 issue。
  3. 查找前端任务: 输入类似 "Find all in progress frontend tasks in Linear" 的指令，服务器将调用 'linear_search_issues' 工具，并使用 "frontend" 和 "In Progress" 等关键词进行搜索。
  4. 获取 issue 更新摘要: 输入类似 "Give me a summary of recent updates on the issues for mobile app development in Linear" 的指令，服务器可能会先调用 'linear_search_issues' 找到相关 issue，然后访问 'linear-issue:///{issueId}' 资源获取 issue 详情和活动记录。
  5. 团队工作负载分析: 输入类似 "What's the current workload for the mobile team in Linear?" 的指令，服务器可能会结合 'linear-team:///{teamId}/issues' 资源和 'linear_search_issues' 工具来分析团队 issue 分布和优先级。

总而言之，您可以使用自然语言与 MCP 客户端交互，指示其通过 Linear MCP Server 操作和查询 Linear 中的项目管理数据。

信息

分类

生产力应用

访问项目