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

Related MCP server: MCP Linear App

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

1. Clonar el repositorio

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

2. Instalar dependencias

npm install

3. Construir el proyecto

npm run build

4. Cree un archivo .env con su token de API lineal

LINEAR_API_KEY=your_linear_api_key_here

5. 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:

1. Habilitar el modo de desarrollador en Claude Desktop (desde la barra de menú)

2. Vaya a Configuración > Opciones de desarrollador

3. Haga clic en "Agregar servidor"

4. 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"]
        }
      }
    ]
  }
}

5. Guardar la configuración

6. Reinicie Claude Desktop (ciérrelo por completo y vuelva a abrirlo)

7. 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:

1. Siga la guía de implementación en el documento TOOLS.md

2. Asegúrese de seguir la estructura de código establecida en el directorio src/

3. Actualice la documentación para reflejar sus cambios

Desarrollando y contribuyendo

Configurar el entorno de desarrollo

1. Clonar el repositorio

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

2. Instalar dependencias

npm install

3. Iniciar en modo de desarrollo

npm run dev

Publicación en npm

Para publicar este paquete en npm:

1. Actualizar la versión en package.json

npm version patch  # or minor, or major

2. Construir el proyecto

npm run build

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

npm login

4. Publicar en npm

npm publish --access public

5. 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.