使用说明

项目简介

Linear MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在通过 LLM 客户端（如 Claude）以自然语言的方式管理 Linear 工作空间中的项目、事务（Issue）和计划（Initiative）。它充当 LLM 与 Linear API 之间的桥梁，将用户的自然语言指令转换为对 Linear API 的操作，从而实现智能化的项目管理和协作。

主要功能点

项目管理：创建、查看和更新 Linear 项目。
计划管理：创建、查看和更新 Linear 计划，以及关联/取消关联计划与项目。
事务管理：创建、查看、更新和搜索 Linear 事务（Issue），以及管理事务之间的关联关系。
资源访问：提供对 Linear 数据的访问能力，例如项目和事务信息。
工具集成：注册并提供一系列工具，允许 LLM 客户端调用这些工具来执行 Linear 工作空间的操作。
Prompt 模板: 内置默认 Prompt 模板，优化与 LLM 的交互体验。

安装步骤

安装 Node.js: 确保你的系统已安装 Node.js 运行时环境 (建议版本 >= 20)。
克隆仓库: 将 GitHub 仓库 'https://github.com/samcfinan/linear-mcp-server' 克隆到本地。
安装依赖: 在仓库根目录下，运行 'npm install' 或 'yarn install' 安装项目依赖。
配置环境变量: 设置 'LINEAR_API_KEY' 环境变量为你的 Linear API 密钥。你可以在 Linear 工作空间的设置中创建 API 密钥。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude），你需要提供以下 JSON 配置信息。请注意，以下配置中的路径需要根据你的实际安装路径进行调整。

{
  "mcpServers": {
    "linear": {
      "command": "/Users/USERNAME/.nvm/versions/node/v22.13.0/bin/node",  // Node.js 的绝对路径。如果未使用 nvm，则为 'node' 或 Node.js 的安装路径。
      "args": [
        "--experimental-strip-types", // 建议保留，用于优化性能
        "/absolute/path/to/repo/index.ts" // index.ts 文件的绝对路径，请替换为你的实际路径
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here" // 你的 Linear API 密钥，请替换为你的实际密钥
      }
    }
  }
}

配置参数说明:

'command': 启动 MCP 服务器的命令，这里指向 Node.js 可执行文件的绝对路径。请根据你的 Node.js 安装方式和路径进行调整。如果 'node' 命令已添加到系统 PATH 环境变量，可以直接使用 'node'。
'args': 传递给 'command' 的参数列表。
- '--experimental-strip-types': 一个 Node.js 运行时参数，用于移除 TypeScript 类型信息，可以提高执行性能。（建议保留）
- '/absolute/path/to/repo/index.ts': 指向仓库中 'index.ts' 文件的绝对路径。你需要将其替换为你的本地仓库 'index.ts' 文件的实际绝对路径。
'env': 环境变量配置。
- 'LINEAR_API_KEY': Linear API 密钥，用于服务器连接到你的 Linear 工作空间。请务必替换为你的实际 API 密钥。

基本使用方法

启动服务器: 在仓库根目录下，运行命令 'npm start' 或 'node --experimental-strip-types index.ts' 启动 MCP 服务器。服务器将通过标准输入/输出 (stdio) 与 MCP 客户端通信。
配置 MCP 客户端: 将上面生成的 JSON 配置信息添加到你的 MCP 客户端（如 Claude Desktop）的服务器配置中。确保 'command', 'args', 和 'env.LINEAR_API_KEY' 配置正确。
使用 LLM 客户端: 在 MCP 客户端中，你可以使用自然语言指令，结合仓库 README.md 中 "Available Tools" 部分列出的工具名称，来管理你的 Linear 工作空间。例如：
- 'Create a new project called '发布新网站''
- 'View issue with ID 'd1aae514' from linear'
- 'Search issues in linear that are assigned to me'

请参考仓库的 README.md 文件和提供的示例，了解更多工具的使用方法和示例。

关键词