使用说明

项目简介

Linear MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接 AI 助手（如 Claude）和 Linear 项目管理工具。通过提供一系列工具，它允许 AI 助手直接访问和操作 Linear 中的项目数据，例如 issues、projects、teams 和 users，从而实现更智能化的项目管理和协作。

主要功能点

• Issue 管理: 检索、创建、更新、搜索 issues，添加评论，管理 issue 标签、指派和状态。
• Project 管理: 检索、创建、更新 projects，将 issues 添加到 projects。
• Team 管理: 检索 teams 和 workflow states。
• User 和组织信息: 获取当前用户、组织和用户列表、标签信息。
• Cycle 管理: 检索 cycles，获取 active cycle，将 issues 添加到 cycle。
• 基于 Linear GraphQL API: 所有功能都基于 Linear 强大的 GraphQL API 实现。
• 易于安装和配置: 可以通过 Smithery 自动安装，也支持手动配置和安装。

安装步骤

1. 环境准备: 确保已安装 Node.js (v18+) 和 npm 或 yarn。

2. 安装 Linear MCP Server:

   推荐方式 (通过 Smithery 自动安装):

   npx -y @smithery/cli install @emmett.deen/linear-mcp-server --client claude
   

   手动安装:

   npm install -g @emmett.deen/linear-mcp-server
   

   或者，您也可以克隆仓库并本地安装：

   git clone https://github.com/emmett-deen/Linear-MCP-Server.git
   cd Linear-MCP-Server
   npm install
   npm link
   

3. 配置 Linear API Token: 您需要一个 Linear API Token 来进行身份验证。可以通过以下方式提供 Token：

   • 命令行参数: 启动服务器时使用 '--token YOUR_LINEAR_API_TOKEN' 参数。
   • 环境变量: 设置 'LINEAR_API_TOKEN' 或 'LINEAR_API_KEY' 环境变量。

服务器配置

要将 Linear MCP Server 连接到 MCP 客户端（例如 Claude Desktop），您需要在客户端的 MCP 设置中添加服务器配置。以下是 Claude Desktop 的配置示例，其他客户端配置方法请参考仓库 README：

在 Claude Desktop 的 'cline_mcp_settings.json' 或 'claude_desktop_config.json' 配置文件中，添加如下 'mcpServers' 配置：

{
  "mcpServers": {
    "linear": {
      "command": "linear-mcp-server", // MCP 服务器启动命令
      "args": ["--token", "YOUR_LINEAR_API_TOKEN"] // 启动参数，YOUR_LINEAR_API_TOKEN 需要替换为您的 Linear API Token
    }
  }
}

基本使用方法

1. 启动服务器: 根据您的安装方式，使用以下命令启动 Linear MCP Server，并确保提供 Linear API Token：

   linear-mcp-server --token YOUR_LINEAR_API_TOKEN
   

   或设置环境变量后直接运行：

   linear-mcp-server
   

2. 在 MCP 客户端中使用: 配置完成后，在您的 MCP 客户端中启用并选择 "Linear MCP Server"。您可以使用自然语言提示词指示 AI 助手调用 Linear 工具，例如：

   • "Show me all my Linear issues" (显示我所有的 Linear issues)
   • "Create a new issue titled 'Fix login bug' in the Frontend team" (在 Frontend 团队创建一个标题为 'Fix login bug' 的 issue)
   • "What are the issues in my 'Marketing' project?" (我的 'Marketing' 项目里有哪些 issues?)

   更多示例请参考仓库 README 和 TOOLS.md 文档。