MCP Linear 应用

Model Context Protocol (MCP) 用于与 Linear 集成，作为 AI 工具。此工具允许您的 AI 通过 Model Context Protocol 与 Linear 进行交互。

功能

• 完整的 Linear 集成：
  • 搜索问题
  • 创建新问题
  • 更新问题
  • 添加评论
  • 更新评论
  • 获取用户资料
  • 获取团队信息

前提条件

• Node.js 18 或更高版本
• Linear API 密钥

如何获取 Linear API 密钥

要使用此应用程序，您需要一个 Linear API 密钥。以下是获取密钥的步骤：

1. 登录或创建 Linear 账户

   • 访问 Linear 并登录到您的现有账户或注册创建一个新账户

2. 访问工作区设置

   • 从主页点击左上角的用户名
   • 选择“Workspace settings”（工作区设置）选项

3. 打开 API 设置

   • 在左侧的“Settings”（设置）列中向下滚动，直到找到“API”
   • 点击“API”选项

4. 创建新的 API 密钥

   • 输入 API 密钥的标签（例如，“MCP Linear App”）
   • 点击“Create new API key”（创建新 API 密钥）按钮

5. 安全存储 API 密钥

   • API 密钥仅显示一次
   • 复制并将其保存在安全位置，因为 Linear 不会再次显示该密钥

重要提示：Linear 对 API 密钥的速率限制为每小时 1,500 次请求。请确保您的应用程序遵循此限制，以避免出现 429 Too Many Requests 错误。

有关获取和使用 Linear API 密钥的更多详细信息，您可以访问 Merge.dev 上的这篇指南。

如何使用该工具

1. 初始设置

1. 克隆此仓库：

git clone git@github.com:zalab-inc/mcp-linear-app.git
cd mcp-linear-app

1. 安装依赖项：

npm install

1. 在根目录中创建一个 .env 文件：

LINEAR_API_KEY=your_linear_api_key_here

1. 构建项目：

npm run build

1. dist 文件夹现在可以用于在各种 AI 平台上进行配置。

2. Cursor 配置

1. 找到您的 Cursor MCP 配置文件：

   • Windows: C:\Users\<username>\.cursor\mcp.json
   • macOS: ~/.cursor/mcp.json
   • Linux: ~/.cursor/mcp.json

2. 编辑文件以添加 Linear MCP 服务器配置：

   {
     "mcpServers": {
       "linear": {
         "command": "<path-to-node>",
         "args": [
           "<path-to-project>/dist/index.js"
         ],
         "env": {
           "LINEAR_API_KEY": "your_linear_api_key_here"
         }
       }
     }
   }
   

3. 替换占位符：

   • <path-to-node>: 您的 Node.js 可执行文件路径
   • <path-to-project>: 您的 MCP Linear App 项目目录的绝对路径
   • your_linear_api_key_here: 您的 Linear API 密钥

示例配置：

{
  "mcpServers": {
    "linear": {
      "command": "C:\\nvm4w\\nodejs\\node.exe",
      "args": [
        "H:\\mcp\\linear\\dist\\index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "lin_api_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

1. 保存文件并重新启动 Cursor 以使更改生效。

3. Claude 配置

要将 MCP Linear 工具与 Claude 一起使用，您需要在 Claude 的设置文件中添加配置。请按照以下步骤操作：

1. 打开 Claude AI 桌面应用程序设置
2. 导航到“开发者”部分
3. 查找“工具”配置部分
4. 按照如下方式添加 Linear MCP 的配置：

{
  "tools": {
    "linear": {
      "command": "<path-to-node>",
      "args": [
        "<path-to-project>/dist/index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

1. 替换占位符：
   • <path-to-node>: 你的 Node.js 可执行文件路径
   • <path-to-project>: 你的 MCP Linear App 项目目录的绝对路径
   • your_linear_api_key_here: 你的 Linear API 密钥

示例配置：

{
  "tools": {
    "linear": {
      "command": "/usr/local/bin/node",
      "args": [
        "/Users/username/projects/mcp-linear-app/dist/index.js"
      ],
      "env": {
        "LINEAR_API_KEY": "lin_api_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

4. 其他平台上的配置

对于其他支持 MCP 的 AI 平台，基本原理相同：

1. 找到外部工具或 MCP 的配置区域
2. 配置它以运行来自此仓库的 dist/index.js 文件的 Node.js
3. 在环境配置中包含你的 LINEAR_API_KEY

可用工具

配置完成后，您的 AI 将能够访问以下 Linear 工具：

• search_issues - 根据关键字、状态或优先级搜索问题
• create_issue - 创建新问题
• get_issue - 获取问题详情
• update_issue - 更新现有问题
• create_comment - 向问题添加评论
• get_comment - 从问题中获取评论
• update_comment - 更新或删除评论
• get_profile - 获取当前 Linear 用户资料
• get_team_id - 获取团队及其 ID 列表

支持和帮助

如果您在使用此工具时遇到问题，请：

1. 检查您的 Linear API 密钥是否有效且具有足够的权限
2. 确保正确安装了 Node.js
3. 检查您 AI 平台中的 MCP 配置
4. 检查日志文件中可能出现的任何错误消息

在 AI 环境中使用 Linear 工具

一旦您在 AI 环境中配置好 Linear 工具，就可以通过提示 AI 开始使用它们。以下是一些示例：

在 Cursor 中使用 Linear 工具

在 Cursor 中，您可以简单地要求 Claude 执行与 Linear 相关的任务：

Search for high priority issues in our Linear project.

Create a new issue in Linear with the title "Improve login page performance" and add it to the backlog.

Get the details of the issue LIN-123 from Linear.

Add a comment to issue LIN-456 saying "This is fixed in the latest release. Please verify."

Update the priority of issue LIN-789 to urgent.

示例工作流程：创建和管理问题

以下是一个示例工作流程，展示了您可能如何使用这些工具：

1. 查找您的团队ID:

   我的Linear团队ID是什么？
   

   Claude将使用get_team_id工具来获取您的团队信息。

2. 创建新问题:

   为工程团队创建一个标题为“实现密码重置功能”的高优先级Linear问题。描述应为“用户需要一种方式在忘记密码时重置密码。”
   

   Claude将使用带有必要参数的create_issue工具。

3. 搜索问题:

   查找所有分配给我的、当前正在进行中的高优先级问题。
   

   Claude将使用带有适当过滤器的search_issues工具。

4. 更新问题:

   更新问题LIN-456，添加描述：“此问题已在所有浏览器上验证并测试过。”
   

   Claude将使用update_issue工具来修改问题。

5. 添加评论:

   在问题LIN-789中添加评论询问：“这仍然是这个冲刺的优先事项吗？”
   

   Claude将使用create_comment工具来添加评论。

6. 检索评论:

   显示问题LIN-321上的所有评论
   

   Claude将使用get_comment工具来获取评论。

这些示例展示了当工具正确配置后，您可以通过AI助手自然地与Linear进行交互。

最近更新

本项目最近通过改进文档和增强Linear工具的功能得到了提升。改进包括：

• 更新了README文件，提供了更清晰的安装和配置说明
• 增强了针对各种AI平台的文档示例
• 改进了具有更好错误处理和响应格式化的Linear工具
• 新增了对管理评论的支持（创建、获取、更新、删除）
• 提升了按状态和优先级筛选的搜索能力

许可证

本项目采用MIT许可证。

https://kelasinovatif.com/