使用说明

项目简介

Linear MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，专门为 Linear 项目管理工具设计。它允许大型语言模型 (LLM) 客户端通过标准化的 MCP 协议，安全、便捷地访问和操作 Linear 中的项目和任务数据。

主要功能点

资源访问 (Resources): 提供对 Linear 核心资源的只读访问能力，包括：
- Issue: 获取指定 Issue 的详细信息，例如标题、描述、状态等。
- Team Issues: 获取指定团队的所有 Issues 列表。
- User Issues: 获取分配给特定用户（或当前用户）的 Issues 列表。
- Organization: 获取 Linear 组织的基本信息。
- Viewer: 获取当前认证用户的个人信息。
工具调用 (Tools): 注册并提供一系列工具，允许 LLM 客户端执行对 Linear 的操作，包括：
- 创建 Issue: 在 Linear 中创建新的 Issue，可指定标题、描述、优先级、团队等。
- 更新 Issue: 更新已存在的 Issue 的属性，例如标题、描述、优先级、状态等。
- 搜索 Issues: 根据关键词、团队、状态、负责人等条件搜索 Issues。
- 获取用户 Issues: 获取分配给指定用户的 Issues 列表。
- 添加评论: 为指定的 Issue 添加评论。
Prompt 模板 (Prompts): 内置默认 Prompt 模板，指导 LLM 客户端如何有效地利用服务器提供的资源和工具与 Linear 进行交互。

安装步骤

环境准备: 确保已安装 Docker 或 uvx (https://prefix.dev/docs/uvx/getting-started)。
获取仓库: 无需手动下载仓库代码，可以使用 'uvx' 或 Docker 直接运行。

服务器配置

MCP 客户端配置 (以 Claude Desktop 为例):

以下 JSON 配置信息用于配置 MCP 客户端 (如 Claude Desktop) 连接到 Linear MCP Server。您需要将 'LINEAR_API_KEY' 替换为您的 Linear API 密钥。

{
  "linear-mcp-server": {
    "command": "docker",
    "args": [
      "run",
      "-it",
      "--rm",
      "-e",
      "LINEAR_API_KEY=lin_api_xxxxxx",  // 替换为您的 Linear API Key
      "linear-mcp-server:latest"
    ]
  }
}

参数说明:

'"linear-mcp-server"': 服务器名称，用于在 MCP 客户端中标识和引用。
'"command": "docker"': 指定启动服务器的命令为 Docker。
'"args"': Docker 命令的参数列表。
- '"run"': Docker 运行命令。
- '"-it"': 以交互模式运行，并分配伪终端。
- '"--rm"': 容器退出后自动删除。
- '"-e", "LINEAR_API_KEY=lin_api_xxxxxx"': 设置环境变量 'LINEAR_API_KEY'，用于 Linear API 认证。请务必替换 'lin_api_xxxxxx' 为您在 Linear 安全设置中创建的 API 密钥。
- '"linear-mcp-server:latest"': Docker 镜像名称和标签。

或者，您可以使用 'uvx' 运行服务器:

{
  "linear-mcp-server": {
    "command": "uvx",
    "args": [
      "--from",
      "git+https://github.com/vinayak-mehta/linear-mcp",
      "linear-mcp"
    ]
  }
}