MCP Linear 应用

用于与 Linear 集成的模型上下文协议 (MCP)，作为一个 AI 工具。此工具允许你的 AI 通过模型上下文协议与 Linear 交互。

功能

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

前提条件

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

如何获取 Linear API 密钥

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

1. 登录或创建 Linear 帐户

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

2. 访问工作区设置

   • 在主页上，单击左上角的用户名
   • 选择“工作区设置”选项

3. 打开 API 设置

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

4. 创建新的 API 密钥

   • 输入 API 密钥的标签（例如，“MCP Linear App”）
   • 单击“创建新的 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

2. 安装依赖项：

npm install

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

LINEAR_API_KEY=your_linear_api_key_here

4. 构建项目：

npm run build

5. 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"
      }
    }
  }
}

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

3. Claude 配置

要将 MCP Linear Tools 与 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"
      }
    }
  }
}

5. 替换占位符：
   • <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 - 按关键字、状态或优先级搜索 issue
• create_issue - 创建新的 issue
• get_issue - 获取 issue 详细信息
• update_issue - 更新现有 issue
• create_comment - 向 issue 添加评论
• get_comment - 从 issue 获取评论
• 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.

（搜索我们 Linear 项目中的高优先级 issue。）

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

（在 Linear 中创建一个新的 issue，标题为“提高登录页面性能”，并将其添加到 backlog。）

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

（从 Linear 获取 issue LIN-123 的详细信息。）

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

（向 issue LIN-456 添加一条评论，内容为“这已在最新版本中修复。请验证。”）

Update the priority of issue LIN-789 to urgent.

（将 issue LIN-789 的优先级更新为紧急。）

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

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

1. 查找你的团队 ID:

   What's my Linear team ID?
   

   （我的 Linear 团队 ID 是什么？） Claude 将使用 get_team_id 工具来获取你的团队信息。

2. 创建新的 issue:

   Create a new Linear issue titled "Implement password reset feature" for the Engineering team with a high priority. The description should be "Users need a way to reset their passwords when they forget them."
   

   （为工程团队创建一个新的 Linear issue，标题为“实现密码重置功能”，优先级很高。描述应为“用户需要一种在忘记密码时重置密码的方法。”） Claude 将使用 create_issue 工具以及必要的参数。

3. 搜索 issue:

   Find all high priority issues assigned to me that are currently in progress.
   

   （查找分配给我且当前正在进行中的所有高优先级 issue。） Claude 将使用 search_issues 工具以及适当的过滤器。

4. 更新 issue:

   Update issue LIN-456 to add the description "This issue has been verified and tested on all browsers."
   

   （更新 issue LIN-456 以添加描述“此 issue 已在所有浏览器上验证和测试。”） Claude 将使用 update_issue 工具来修改 issue。

5. 添加评论:

   Add a comment to issue LIN-789 asking "Is this still a priority for this sprint?"
   

   （向 issue LIN-789 添加一条评论，询问“这仍然是本次 sprint 的优先事项吗？”） Claude 将使用 create_comment 工具来添加评论。

6. 检索评论:

   Show me all the comments on issue LIN-321
   

   (显示 issue LIN-321 上的所有评论) Claude 将使用 get_comment 工具来获取评论。

这些示例演示了在正确配置工具后，你可以多么自然地通过 AI 助手与 Linear 交互。

最近更新

该项目最近得到了增强，改进了文档和 Linear 工具的功能。改进包括：

• 更新了 README，其中包含更清晰的安装和配置说明
• 增强了文档，其中包含各种 AI 平台的示例
• 改进了 Linear 工具，具有更好的错误处理和响应格式
• 增加了对管理评论的支持（创建、获取、更新、删除）
• 改进了搜索功能，可以通过状态和优先级进行过滤

许可证

该项目已获得 MIT 许可证的许可。

https://kelasinovatif.com/