使用说明

项目简介

Linear MCP Server 是一个 MCP 服务器,旨在桥接大型语言模型(LLM)客户端和 Linear 项目管理工具。通过此服务器,LLM 能够以标准化的方式访问和操作 Linear 中的 issues、团队和用户信息,实现智能化的任务管理和工作流自动化。

主要功能点

  • Issue 管理: 创建、更新和搜索 Linear 中的 issue,包括标题、描述、优先级、状态、指派人、标签等。
  • 评论功能: 允许 LLM 向 Linear issue 添加评论。
  • 资源访问: 提供对 Linear issue、团队、用户和组织信息的资源访问能力,方便 LLM 获取上下文信息。
  • 工具集成: 提供一系列预定义的工具,如创建 issue、更新 issue、搜索 issue、获取用户 issue 和添加评论等,供 LLM 调用执行具体操作。
  • 灵活查询: 支持多种过滤条件搜索 issue,例如关键词、团队、状态、指派人、标签和优先级等。
  • 用户信息: 可以获取当前用户和组织的相关信息。

安装步骤

  1. 获取 Linear API Key: 访问 https://linear.app/YOUR-TEAM/settings/api (请将 YOUR-TEAM 替换为你的 Linear 团队名称),创建一个 Linear API 密钥。
  2. 配置 Claude Desktop:
    • 打开 Claude Desktop 的配置文件 'claude_desktop_config.json'。
      • MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
    • 在 'claude_desktop_config.json' 文件中,添加 'mcpServers' 配置,如下所示:

服务器配置

以下是在 'claude_desktop_config.json' 中配置 Linear MCP Server 的示例。请根据你的实际情况进行配置。

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

配置参数说明:

  • 'server name': 'linear' - 服务器名称,可以自定义,用于在 Claude Desktop 中标识和调用该服务器。
  • 'command': 'npx' - 启动服务器的命令,这里使用 'npx' 运行 npm 包。
  • 'args':
    • '-y': 'npx' 的参数,表示自动确认执行 npm 包。
    • 'linear-mcp-server': 要运行的 npm 包名称,即 Linear MCP Server。
  • 'env': 环境变量配置。
    • 'LINEAR_API_KEY': 必须配置,替换为你在 Linear 网站上创建的 API 密钥。

请注意: 你需要将 'your_linear_api_key_here' 替换为你实际的 Linear API 密钥。

基本使用方法

配置完成后,在 Claude Desktop 中,你可以通过自然语言指令调用 Linear MCP Server 的功能。以下是一些示例:

  • 创建 Issue: "创建一个标题为 '修复用户登录 bug',团队为 '技术支持' 的 issue"
  • 搜索 Issue: "搜索所有指派给我的高优先级 issue"
  • 查看 Issue 详情: "打开 issue 编号为 'PROJECT-123' 的 issue"
  • 添加评论: "在 issue 编号为 'PROJECT-456' 的 issue 中添加评论 '这个问题已经解决,可以关闭了'"

通过这些指令,LLM 可以调用 Linear MCP Server 提供的工具和资源,与 Linear 项目管理工具进行交互,实现更智能的任务管理和协作。

信息

分类

生产力应用