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:
- Construir el proyecto:
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)
}
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:
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)