Quire MCP Server

⚠️ Aviso: Proyecto de Codificación "Vibe" ⚠️

Este es un proyecto de codificación basado en "vibraciones". Aunque es funcional, se desarrolla con un enfoque en la implementación rápida y la experimentación. Úsalo bajo tu propio riesgo. El autor no es responsable de ninguna consecuencia, pérdida de datos o comportamiento inesperado que pueda surgir de su uso.

---

Servidor MCP de Quire

Este proyecto proporciona un servidor Protocolo de Contexto de Modelo (MCP) para Quire. Expone herramientas que permiten a los asistentes de IA interactuar con tus proyectos y tareas directamente desde tu interfaz de chat de IA.

Este servidor utiliza OAuth2 para la autenticación y está diseñado para ejecutarse fácilmente mediante npx.

1. Obtención de tus Credenciales de Quire

Este servidor utiliza un token de actualización OAuth2 para la autenticación. Solo necesitas realizar este proceso de configuración una vez.

Paso 1: Crear una Aplicación de Quire

1. Ve a la página de Aplicaciones de Quire.
2. Haz clic en Crear una nueva aplicación.
3. Completa los detalles:
   • Nombre: Dale un nombre a tu aplicación (por ejemplo, "Mi-Cliente-MCP").
   • Sitio web: Puedes usar un marcador de posición, como https://localhost.
   • URI de redirección: Establécelo en https://localhost. Esto es crucial para el siguiente paso.
4. Después de crear la aplicación, anota el ID de cliente y el Secreto de cliente.

Paso 2: Obtener un Código de Autorización

1. Construye la siguiente URL en tu navegador, reemplazando YOUR_CLIENT_ID con el ID que obtuviste en el paso anterior.

   https://quire.io/oauth?client_id=YOUR_CLIENT_ID&redirect_uri=https://localhost
   

2. Visita la URL. Se te pedirá que inicies sesión en Quire y autorices la aplicación.
3. Después de autorizar, tu navegador será redirigido a una página en blanco con una URL como: https://localhost/?code=SOME_LONG_CODE
4. Copia el valor de code de la URL. Este código es temporal y se utilizará en el siguiente paso.

Paso 3: Intercambiar el Código por un Token de Actualización

1. Abre tu terminal y usa curl para hacer una solicitud POST al endpoint de tokens de Quire.

2. Reemplaza los marcadores de posición con tus credenciales reales.

   curl -X POST https://quire.io/oauth/token \
     -d grant_type=authorization_code \
     -d code=PASTE_THE_CODE_FROM_STEP_2_HERE \
     -d client_id=YOUR_CLIENT_ID \
     -d client_secret=YOUR_CLIENT_SECRET
   

3. La respuesta será un objeto JSON que contiene tu access_token y refresh_token.

4. Guarda el valor de refresh_token. Este es el token que usarás para ejecutar el servidor. Es de larga duración y se utilizará para obtener automáticamente nuevos tokens de acceso.

2. Inicio Rápido y Uso

Establecer Variables de Entorno

Establece las siguientes tres variables de entorno en tu terminal.

# Replace with the credentials you obtained above
export QUIRE_CLIENT_ID="your_client_id"
export QUIRE_CLIENT_SECRET="your_client_secret"
export QUIRE_REFRESH_TOKEN="your_refresh_token"

Ejecutar con npx

Una vez que las variables de entorno estén establecidas, puedes ejecutar el servidor con un solo comando:

npx quire-mcp

3. Guía de Configuración para Cursor

1. Encuentra tu archivo mcp.json: ~/.cursor-settings/mcp.json

2. Agrega la configuración del servidor:

   {
     "mcpServers": {
       "quire": {
         "command": "npx",
         "args": [
           "-y",
           "quire-mcp"
         ],
         "env": {
           "QUIRE_CLIENT_ID": "${env:QUIRE_CLIENT_ID}",
           "QUIRE_CLIENT_SECRET": "${env:QUIRE_CLIENT_SECRET}",
           "QUIRE_REFRESH_TOKEN": "${env:QUIRE_REFRESH_TOKEN}"
         }
       }
     }
   }
   

3. Asegúrate de que las Variables de Entorno estén Establecidas: Antes de iniciar Cursor, asegúrate de que las variables estén configuradas en tu entorno de shell (.zshrc, .bash_profile, etc.).

4. Reinicia Cursor para cargar el nuevo servidor MCP.

4. Para Desarrolladores

Ejecutar desde el Código Fuente

1. Clona e instala las dependencias:

   git clone <repository_url>
   cd quire-mcp && npm install
   

2. Crea un archivo .env:

   QUIRE_CLIENT_ID=your_client_id
   QUIRE_CLIENT_SECRET=your_client_secret
   QUIRE_REFRESH_TOKEN=your_refresh_token
   

3. Ejecuta el servidor:

   npm run build
   npm start
   

Ejecutar Pruebas

npm test

Características

• Listar proyectos
• Listar tareas dentro de un proyecto
• (Se agregarán más características)