Servidor MCP lineal

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para la API GraphQL lineal que permite a los asistentes de IA interactuar con los sistemas de gestión de proyectos lineales.

Características

Acceso a la API GraphQL de Linear a través de herramientas MCP
Autenticación mediante clave API lineal
Recuperar y modificar datos relacionados con usuarios, equipos, proyectos y problemas.
Crear, actualizar y comentar problemas
Agregar y eliminar etiquetas
Crear proyectos
Documentación completa de las herramientas disponibles

Instalación

Instalación mediante herrería (recomendado)

Para instalar Linear MCP Server para Claude Desktop automáticamente a través de Smithery:

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

Configuración manual

Después de la instalación, agregue lo siguiente a su archivo de configuración de MCP:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@emmett.deen/linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Ubicaciones de configuración específicas del cliente

Escritorio de Claude: ~/Library/Application Support/Claude/claude_desktop_config.json
Extensión VSCode de Claude: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
GoMCP: ~/.config/gomcp/config.yaml

Instalación manual

Clonar el repositorio

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

Instalar dependencias

npm install

Construir el proyecto

npm run build

Cree un archivo .env con su token de API lineal

LINEAR_API_KEY=your_linear_api_key_here

Iniciar el servidor

npm start

Herramientas disponibles

Consulte TOOLS.md para obtener una lista completa de las herramientas disponibles y las funciones planificadas.

Descripción general

Linear-MCP-Server conecta a Claude (asistente de IA) con Linear (herramienta de gestión de proyectos) mediante la implementación del protocolo MCP. Esto permite a Claude:

Recupere problemas, proyectos, equipos y otros datos de Linear
Crear y actualizar problemas
Cambiar el estado del problema
Asignar problemas a los miembros del equipo
Añadir comentarios
Crear proyectos y equipos

El servidor utiliza la API GraphQL de Linear y se autentica a través de tokens de usuario (no OAuth) para simplificar.

Empezando

Prerrequisitos

Node.js (versión 18+)
NPM o Hilo
Token de API lineal

Instalación

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

# Or clone and install locally
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server
npm install
npm link  # Makes the package available globally

Ejecución del servidor

Ejecute el servidor con su token de API lineal:

linear-mcp-server --token YOUR_LINEAR_API_TOKEN

O configure el token en su entorno y ejecútelo sin argumentos:

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
linear-mcp-server

Uso con Claude Desktop

Para utilizar este servidor MCP con Claude Desktop:

Habilitar el modo de desarrollador en Claude Desktop (desde la barra de menú)
Vaya a Configuración > Opciones de desarrollador
Haga clic en "Agregar servidor"
Configure con los siguientes ajustes:
- Nombre : Servidor MCP lineal
- Tipo : Proceso local
- Comando : linear-mcp-server
- Argumentos : --token SU_TOKEN_API_LINEAL

Alternativamente, edite manualmente el archivo de configuración:

{
  "mcp": {
    "servers": [
      {
        "name": "Linear MCP Server",
        "transport": {
          "type": "stdio",
          "command": "linear-mcp-server",
          "args": ["--token", "YOUR_LINEAR_API_TOKEN"]
        }
      }
    ]
  }
}

Guardar la configuración
Reinicie Claude Desktop (ciérrelo por completo y vuelva a abrirlo)
Ahora debería ver Linear MCP Server disponible como herramienta en Claude

Ejemplo de indicaciones de Claude

Una vez conectado a Claude Desktop, podrá utilizar indicaciones como:

"Muéstrame todos mis problemas lineales"
Crear un nuevo problema titulado "Corregir error de inicio de sesión" en el equipo de Frontend.
Cambiar el estado del problema FE-123 a 'En proceso'
Asignar el problema BE-456 a John Smith
Añadir un comentario al problema UI-789: "Esto debe solucionarse antes del viernes".

Desarrollo

Para desarrollar localmente:

# Clone the repository
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

# Install dependencies
npm install

# Run in development mode
npm run dev -- --token YOUR_LINEAR_API_TOKEN

Ampliación del servidor

Para agregar nuevas herramientas al servidor:

Siga la guía de implementación en el documento TOOLS.md
Asegúrese de seguir la estructura de código establecida en el directorio src/
Actualice la documentación para reflejar sus cambios

Desarrollando y contribuyendo

Configurar el entorno de desarrollo

Clonar el repositorio

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

Instalar dependencias

npm install

Iniciar en modo de desarrollo

npm run dev

Publicación en npm

Para publicar este paquete en npm:

Actualizar la versión en package.json

npm version patch  # or minor, or major

Construir el proyecto

npm run build

Asegúrate de que ya hayas iniciado sesión en npm

npm login

Publicar en npm

npm publish --access public

Para el registro de Smithery, deberá trabajar con el equipo de Smithery para que su servidor aparezca en su catálogo.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.