项目简介

这是一个基于Model Context Protocol (MCP) 实现的服务器，旨在将您的AI助手（如Claude、VS Code Copilot等MCP兼容客户端）与Linear任务管理系统集成。通过这个服务器，AI可以理解并执行与Linear任务相关的操作。

主要功能点

该服务器通过提供以下标准化工具，使AI能够与Linear交互：

• 获取任务详情 ('get_ticket'): 根据Linear任务的ID（例如 'LAR-123'）获取该任务的详细信息，包括状态、优先级、负责人、描述、评论等。
• 列出我的任务 ('get_my_issues'): 获取分配给当前Linear用户的任务列表，支持按状态（活跃、待办、已完成、已取消或全部）进行过滤。
• 添加评论 ('add_comment'): 为指定的Linear任务添加新的评论。
• 创建新任务 ('create_issue'): 在指定的Linear团队中创建一个新的任务，可以设置标题、描述、优先级、负责人，并支持创建子任务。
• 查看团队列表 ('get_teams'): 获取Linear工作空间中所有可用团队的列表，方便在创建任务时选择团队。
• 搜索任务 ('search_issues'): 根据多种条件（如是否未分配、特定团队、特定状态、是否在当前周期等）搜索Linear任务。

安装步骤

这个MCP服务器通常不是一个需要您手动独立安装并启动的应用程序。它被设计为由MCP兼容的AI客户端（如VS Code、Cursor IDE、Claude Desktop App等）按需自动下载和运行。

您需要做的主要准备工作是：

1. 获取Linear API Key: 访问您的Linear账户设置（通常在账号 -> 安全 或 API 密钥部分），创建一个新的个人API密钥。这是服务器连接到您的Linear工作空间所必需的凭证。

服务器配置

您需要在您的AI客户端的MCP配置中添加该服务器。配置方式因客户端而异，但通常涉及以下信息（无需复制下面的代码，只需理解配置的含义）：

• 服务器名称: 给这个Linear服务器起一个标识名称，例如 'linear'。
• 启动命令 (command): 通常是 'npx'。
• 启动参数 (args): 通常是 '-y' 和 '@larryhudson/linear-mcp-server'。这告诉'npx'工具运行指定的npm包。
• 环境变量 (env): 配置一个名为 'LINEAR_API_KEY' 的环境变量，其值设置为您在步骤1中获取的Linear API Key。某些客户端可能会在运行时提示您输入此密钥，并自动将其设置为环境变量。

请查阅您的AI客户端的官方文档，了解如何在其MCP设置中添加新的服务器配置。

基本使用方法

成功配置并启动服务器后，您的AI助手将能够识别并使用由该服务器提供的Linear工具。您可以通过向AI提出自然语言的问题或指令来与其交互，AI将根据您的意图调用相应的Linear工具。

例如，您可以问AI：

• "Show me the details of Linear ticket ENG-456."
• "List my active issues in Linear."
• "Add a comment to issue PROD-10 saying 'Tested and confirmed the bug.'"
• "Create a new issue in the 'Marketing' team titled 'Update website banner' with high priority."

AI会通过MCP协议调用服务器上的工具，并将结果返回给您。