Linear MCP 服务器

注意：这是一个自定义实现。对于官方的 Cline Linear MCP 服务器，请参阅 cline/linear-mcp。

一个模型上下文协议 (MCP) 服务器，提供与 Linear API 交互的工具，使 AI 代理能够通过 Linear 平台以编程方式管理问题、项目和团队。

功能

• 问题管理

  • 创建具有可自定义属性（标题、描述、团队、负责人、优先级、标签）的新问题
  • 使用灵活的过滤选项（团队、负责人、状态）列出问题
  • 更新现有问题（标题、描述、状态、负责人、优先级）

• 团队管理

  • 列出工作区中的所有团队
  • 访问团队详细信息，包括 ID、名称、密钥和描述

• 项目管理

  • 列出所有项目，并可选择团队过滤
  • 查看项目详细信息，包括名称、描述、状态和关联团队

前提条件

• Node.js (v16 或更高版本)
• 具有 API 访问权限的 Linear 帐户
• 具有适当权限的 Linear API 密钥

快速开始

1. 从 Linear 的开发者设置 获取您的 Linear API 密钥

2. 使用您的 API 密钥运行：

LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

或者在您的环境中设置它：

export LINEAR_API_KEY=your-api-key
npx @ibraheem4/linear-mcp

开发设置

1. 克隆存储库：

git clone [repository-url]
cd linear-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

使用 Inspector 运行

对于本地开发和调试，您可以使用 MCP Inspector：

1. 安装 supergateway：

npm install -g supergateway

2. 使用包含的 run.sh 脚本：

chmod +x run.sh
LINEAR_API_KEY=your-api-key ./run.sh

3. 访问 Inspector：
   • 在您的浏览器中打开 localhost:1337
   • Inspector 通过服务器发送事件 (SSE) 连接
   • 通过 Inspector 界面测试和调试工具调用

配置

根据您的客户端在设置文件中配置 MCP 服务器：

对于 Claude Desktop

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

对于 VS Code 扩展 (Cline)

位置：~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

对于 Cursor (cursor.sh)

对于 Cursor，服务器必须使用完整路径运行：

node /Users/ibraheem/Projects/linear-mcp/build/index.js

可用工具

create_issue

在 Linear 中创建一个新问题。

{
  title: string;          // 必需：问题标题
  description?: string;   // 可选：问题描述（支持 markdown）
  teamId: string;        // 必需：团队 ID
  assigneeId?: string;   // 可选：负责人用户 ID
  priority?: number;     // 可选：优先级 (0-4)
  labels?: string[];     // 可选：要应用的标签 ID
}

list_issues

列出问题，并可选择过滤器。

{
  teamId?: string;      // 可选：按团队 ID 过滤
  assigneeId?: string;  // 可选：按负责人 ID 过滤
  status?: string;      // 可选：按状态过滤
  first?: number;       // 可选：要返回的问题数量（默认：50）
}

update_issue

更新现有问题。

{
  issueId: string;       // 必需：问题 ID
  title?: string;        // 可选：新标题
  description?: string;  // 可选：新描述
  status?: string;      // 可选：新状态
  assigneeId?: string;  // 可选：新负责人 ID
  priority?: number;    // 可选：新优先级 (0-4)
}

list_teams

列出工作区中的所有团队。不需要参数。

list_projects

列出所有项目，并可选择过滤。

{
  teamId?: string;     // 可选：按团队 ID 过滤
  first?: number;      // 可选：要返回的项目数量（默认：50）
}

get_issue

获取有关特定问题的详细信息。

{
  issueId: string; // 必需：问题 ID
}

开发

对于使用自动重建进行开发：

npm run watch

错误处理

服务器包括全面的错误处理，用于：

• 无效的 API 密钥
• 缺少必需的参数
• Linear API 错误
• 无效的工具请求

所有错误都经过正确格式化并返回描述性消息。

技术细节

使用以下技术构建：

• TypeScript
• Linear SDK (@linear/sdk v37.0.0)
• MCP SDK (@modelcontextprotocol/sdk v0.6.0)

服务器使用 stdio 进行通信，并实现模型上下文协议，以便与 AI 代理无缝集成。

许可证

MIT