Servidor MCP lineal

Nota: Esta es una implementación personalizada. Para el servidor oficial de Cline Linear MCP, consulte cline/linear-mcp .

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona herramientas para interactuar con la API de Linear, lo que permite a los agentes de IA gestionar problemas, proyectos y equipos de forma programada a través de la plataforma Linear.

Características

Gestión de problemas
- Cree nuevos problemas con propiedades personalizables (título, descripción, equipo, asignado, prioridad, etiquetas)
- Enumere problemas con opciones de filtrado flexibles (equipo, asignado, estado)
- Actualizar los problemas existentes (título, descripción, estado, cesionario, prioridad)
Gestión de equipos
- Enumerar todos los equipos en el espacio de trabajo
- Acceda a los detalles del equipo, incluidos ID, nombre, clave y descripción.
Gestión de proyectos
- Enumere todos los proyectos con filtrado de equipo opcional
- Ver detalles del proyecto, incluido el nombre, la descripción, el estado y los equipos asociados

Prerrequisitos

Node.js (v16 o superior)
Una cuenta lineal con acceso API
Clave API lineal con permisos adecuados

Inicio rápido

Obtén tu clave API de Linear desde la Configuración para desarrolladores de Linear
Ejecutar con su clave API:

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

O configúrelo en su entorno:

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

Configuración de desarrollo

Clonar el repositorio:

git clone [repository-url]
cd linear-mcp

Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Corriendo con Inspector

Para el desarrollo y la depuración local, puede utilizar el Inspector MCP:

Instalar supergateway:

npm install -g supergateway

Utilice el script run.sh incluido:

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

Acceder al Inspector:
- Abra localhost:1337 en su navegador
- El Inspector se conecta a través de eventos enviados por el servidor (SSE)
- Pruebe y depure las llamadas a herramientas a través de la interfaz del Inspector

Configuración

Configure el servidor MCP en su archivo de configuración en función de su cliente:

Para Claude Desktop

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas: %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": []
    }
  }
}

Para la extensión de VS Code (Cline)

Ubicación: ~/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": []
    }
  }
}

Para el cursor ( cursor.sh )

Para Cursor, el servidor debe ejecutarse con la ruta completa:

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

Herramientas disponibles

crear_problema

Crea un nuevo problema en Linear.

{
  title: string;          // Required: Issue title
  description?: string;   // Optional: Issue description (markdown supported)
  teamId: string;        // Required: Team ID
  assigneeId?: string;   // Optional: Assignee user ID
  priority?: number;     // Optional: Priority (0-4)
  labels?: string[];     // Optional: Label IDs to apply
}

lista_de_problemas

Enumera problemas con filtros opcionales.

{
  teamId?: string;      // Optional: Filter by team ID
  assigneeId?: string;  // Optional: Filter by assignee ID
  status?: string;      // Optional: Filter by status
  first?: number;       // Optional: Number of issues to return (default: 50)
}

problema de actualización

Actualiza un problema existente.

{
  issueId: string;       // Required: Issue ID
  title?: string;        // Optional: New title
  description?: string;  // Optional: New description
  status?: string;      // Optional: New status
  assigneeId?: string;  // Optional: New assignee ID
  priority?: number;    // Optional: New priority (0-4)
  labels?: string[];   // Optional: Label IDs to apply to the issue
}

lista_equipos

Enumera todos los equipos del espacio de trabajo. No se requieren parámetros.

lista_proyectos

Enumera todos los proyectos con filtrado opcional.

{
  teamId?: string;     // Optional: Filter by team ID
  first?: number;      // Optional: Number of projects to return (default: 50)
}

obtener_problema

Obtiene información detallada sobre un problema específico.

{
  issueId: string; // Required: Issue ID
}

Desarrollo

Para desarrollo con reconstrucción automática:

npm run watch

Manejo de errores

El servidor incluye un manejo integral de errores para:

Claves API no válidas
Faltan parámetros requeridos
Errores de API lineal
Solicitudes de herramientas no válidas

Todos los errores se formatean correctamente y se devuelven con mensajes descriptivos.

Detalles técnicos

Construido con:

Mecanografiado
SDK lineal (@linear/sdk v37.0.0)
Kit de desarrollo de software de MCP (@modelcontextprotocol/sdk v0.6.0)

El servidor utiliza stdio para la comunicación e implementa el Protocolo de Contexto de Modelo para una integración perfecta con agentes de IA.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Linear MCP Server

Integrations