Linear MCP Server - FindMCP.info

Overview

基本能力

产品定位

Linear MCP Server 是一个专门用于与 Linear 问题跟踪系统集成的 MCP 服务器，为 AI 模型提供标准化的接口来访问和操作 Linear 的功能。

核心功能

标准 MCP 协议实现，使用官方 MCP SDK
支持搜索问题、读取详细信息、更新和评论
遵循函数式编程原则的清晰架构
基于 Node.js 实现，使用官方 MCP SDK

适用场景

在 AI 助手（如 Claude Desktop 或 Cursor）中集成 Linear 问题跟踪功能
自动化处理 Linear 中的任务和问题
通过 AI 模型与 Linear 系统进行交互

工具列表

list_tickets：列出 Linear 票据，支持多种过滤选项（如分配人、状态等）

常见问题解答

检查 Linear API 密钥：确保在 .env 文件或环境变量中设置了有效的 Linear API 密钥。Linear API 密钥应以 "lin_api_" 开头。
启用调试日志：
启动 MCP 服务器时使用 just debug 或 LOG_LEVEL=DEBUG NODE_ENV=development node src/index.js
在客户端配置中添加 "LOG_LEVEL": "DEBUG"
直接调用工具时添加 "debug": true 参数
检查日志文件：查看 logs/mcp-linear.log 文件中的详细错误信息。
验证 Linear API 访问：确保 Linear API 密钥具有适当的权限，并且可以直接访问 Linear API。

使用教程

使用依赖

Node.js（v18 或更高版本）
Linear API 密钥

安装教程

克隆仓库
安装依赖

npm install

在根目录创建 .env 文件，包含你的 Linear API 密钥

LINEAR_API_KEY=your_linear_api_key_here

运行服务器

启动服务器：

npm start

开发时使用文件监视：

just dev

开发时使用调试日志：

just debug

或手动设置环境变量：

LOG_LEVEL=DEBUG NODE_ENV=development node src/index.js

使用 MCP Inspector

在一个终端启动服务器：

npm start

访问基于 web 的检查器：https://inspector.modelcontextprotocol.ai
选择 "stdio" 作为传输类型
输入以下命令：

node /path/to/mcp-linear/src/index.js

点击 "Connect" 连接到正在运行的服务器

与 Claude Desktop 集成

在 Claude Desktop 配置文件（通常位于 ~/.config/Claude Desktop/claude_desktop_config.json）中添加：

{
  "mcp": {
    "servers": [
      {
        "name": "Linear",
        "command": "node /path/to/mcp-linear/src/index.js",
        "env": {
          "LINEAR_API_KEY": "your_linear_api_key_here",
          "LOG_LEVEL": "DEBUG", 
          "NODE_ENV": "development"
        }
      }
    ]
  }
}

与 Cursor 集成

在 Cursor 设置中添加：

{
  "ai.mcp.servers": [
    {
      "name": "Linear",
      "command": "node /path/to/mcp-linear/src/index.js",
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here",
        "LOG_LEVEL": "DEBUG", 
        "NODE_ENV": "development"
      }
    }
  ]
}

测试集成

在 Claude Desktop 或 Cursor 设置中配置 MCP 服务器
重启应用程序
询问："Search for Linear issues containing 'bug'"
助手应检测并使用 Linear MCP 服务器检索结果

调试方式

使用 just debug 或 LOG_LEVEL=DEBUG NODE_ENV=development node src/index.js 启动服务器以启用调试日志
检查 logs/mcp-linear.log 文件中的日志信息
在客户端配置中设置 "LOG_LEVEL": "DEBUG" 以获取更多调试信息

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。