🚀 Linear-MCP-for-Gemini_CLI

Un potente servidor de Protocolo de Contexto de Modelo (MCP) de código abierto, creado específicamente para conectar Gemini CLI directamente con tu espacio de trabajo de Linear. Gestiona incidencias, equipos y flujos de trabajo sin problemas mediante lenguaje natural, directamente desde tu terminal.

🌟 Características

• 🔍 Búsqueda y descubrimiento: Encuentra incidencias en todo tu espacio de trabajo directamente desde Gemini CLI.

• 📝 Gestión de incidencias: Obtén, crea y actualiza incidencias (estado, prioridad, responsable, etc.) sin esfuerzo.

• 💬 Colaboración: Añade comentarios a las incidencias sin salir de tu terminal.

• 🏢 Información del espacio de trabajo: Enumera equipos, usuarios y estados de flujo de trabajo para proporcionar contexto completo a Gemini.

• ⚡ Integración en tiempo real: Construido sobre el Protocolo de Contexto de Modelo para una comunicación segura y de baja latencia.

📋 Requisitos previos

Antes de empezar, asegúrate de tener instalado lo siguiente:

• Node.js: Versión 18.0.0 o superior.

• Gemini CLI: Instalado y configurado en tu máquina.

• Cuenta de Linear: Con acceso para generar una clave API.

📖 Guía completa de integración con Gemini CLI

Este servidor está escrito en TypeScript. Dado que Gemini CLI requiere un ejecutable de JavaScript estándar para ejecutar servidores MCP, primero debemos descargar y "compilar" el proyecto.

Sigue estos 4 pasos para conectar todo.

Paso 1: Descargar y compilar el servidor

1. Clona el repositorio en tu máquina:

   git clone https://github.com/tenx-studio/Linear-MCP.git
   cd linear-mcp-open-source

2. Instala los paquetes necesarios:

   npm install

3. Compila el código:

   npm run build

   (¿Por qué hacer esto? Este comando traduce el código TypeScript a un archivo dist/index.js, que es el archivo exacto que Gemini CLI utilizará para comunicarse con Linear).

Paso 2: Obtén tu clave API de Linear

1. Navega a Settings > API > Personal API keys en tu espacio de trabajo de Linear.

2. Haz clic en New API key y dale un nombre descriptivo (por ejemplo, "Gemini CLI").

3. Copia la clave (la necesitarás para el paso final).

Paso 3: Conectar a Gemini CLI (la única configuración que necesitas)

Ahora le indicamos a Gemini CLI dónde encontrar el servidor compilado y le proporcionamos de forma segura tu clave API. Para ello, edita el archivo de configuración de Gemini CLI.

1. Localiza tu archivo de configuración: Abre tu explorador de archivos o terminal y busca la carpeta .gemini en el directorio personal de tu usuario:

   • Windows: %USERPROFILE%\.gemini\settings.json (por ejemplo, C:\Users\TuNombre\.gemini\settings.json)

   • Mac/Linux: ~/.gemini/settings.json (Nota: Si la carpeta .gemini o el archivo settings.json aún no existen, simplemente créalos).

2. Añade la configuración: Abre settings.json en cualquier editor de texto (como VS Code, Notepad o TextEdit) y pega el siguiente bloque mcp. Si tu archivo ya tiene contenido, simplemente añade la sección "mcp" dentro de los corchetes principales {}:

{
  "mcp": {
    "servers": {
      "linear": {
        "command": "node",
        "args": ["/ABSOLUTE/PATH/TO/linear-mcp-open-source/dist/index.js"],
        "env": {
          "LINEAR_API_KEY": "lin_api_your_key_here"
        }
      }
    }
  }
}

⚠️ Ajustes cruciales:

• args: DEBES reemplazar /ABSOLUTE/PATH/TO/... con la ruta completa y real en tu ordenador donde clonaste este repositorio. (por ejemplo, "D:/Projects/linear-mcp-open-source/dist/index.js").

• LINEAR_API_KEY: Reemplaza lin_api_your_key_here con la clave API exacta que copiaste en el Paso 2.

Paso 4: ¡Empieza a chatear!

Cierra y vuelve a abrir tu terminal para reiniciar tu sesión de Gemini CLI. ¡La integración ya está activa!

Intenta pedirle a Gemini CLI cosas como:

*"Enumera mis equipos de Linear." *"Busca la incidencia sobre el error de inicio de sesión." *"Crea una nueva incidencia de alta prioridad en el equipo de Ingeniería para actualizar el README."

🤖 Magia de autoconexión (Cómo funciona)

Quizás te preguntes: *"¿Tengo que ejecutar npm start cada vez que quiera usar esto? ¿Tengo que configurar manualmente una conexión al servidor?"

¡No! No tienes que hacer nada extra.

Añadir el bloque de configuración en el Paso 3 es la única configuración necesaria. Esto es exactamente lo que sucede internamente:

1. Inicio sin intervención: Como añadiste la configuración a tu settings.json, Gemini CLI actúa de forma nativa como host.

2. Ejecución en segundo plano: Cada vez que inicias un nuevo chat en Gemini CLI, este inicia automáticamente este servidor MCP de Linear en un proceso oculto en segundo plano.

3. Handshake seguro: Gemini CLI lee la "LINEAR_API_KEY" de tu configuración y la inyecta de forma segura directamente en el servidor.

4. Apagado limpio: Cuando cierras Gemini CLI, el servidor en segundo plano se termina automáticamente.

¡Solo lo configuras una vez en tus ajustes y el Protocolo de Contexto de Modelo gestiona todo el ciclo de vida por ti automáticamente!

🤝 Contribuciones

Las contribuciones son lo que hacen que la comunidad de código abierto sea un lugar tan increíble para aprender, inspirar y crear. Cualquier contribución que hagas es muy apreciada.

1. Haz un Fork del proyecto

2. Crea tu rama de características (git checkout -b feature/AmazingFeature)

3. Confirma tus cambios (git commit -m 'Add some AmazingFeature')

4. Envía a la rama (git push origin feature/AmazingFeature)

5. Abre una Pull Request

📄 Licencia

Este proyecto está bajo la Licencia ISC.

Creado con ❤️ para la comunidad de desarrolladores de IA.