Ragie

¡IMPORTANTE!

Este proyecto ya no es necesario. Ragie ahora soporta MCP de forma nativa como un servidor HTTP transmisible. Consulta la documentación aquí: [https://docs.ragie.ai/docs/mcp-overview]

Si deseas que los usuarios dentro de tu empresa puedan acceder a tu base de conocimiento en aplicaciones como Claude o ChatGPT, es posible que necesites MCP Bridge

Servidor de Protocolo de Contexto de Modelo de Ragie

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a las capacidades de recuperación de la base de conocimiento de Ragie.

Descripción

Este servidor implementa el Protocolo de Contexto de Modelo para permitir que los modelos de IA recuperen información de una base de conocimiento de Ragie. Proporciona una única herramienta llamada "retrieve" que permite consultar la base de conocimiento en busca de información relevante.

Requisitos previos

• Node.js >= 18
• Una clave API de Ragie

Instalación

El servidor requiere la siguiente variable de entorno:

• RAGIE_API_KEY (obligatorio): Tu clave de autenticación API de Ragie

El servidor se iniciará y escuchará en stdio los mensajes del protocolo MCP.

Instala y ejecuta el servidor con npx:

RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server

Opciones de línea de comandos

El servidor admite las siguientes opciones de línea de comandos:

• --description, -d <text>: Sobrescribe la descripción predeterminada de la herramienta con texto personalizado
• --partition, -p <id>: Especifica el ID de partición de Ragie para consultar

Ejemplos:

# With custom description
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server --description "Search the company knowledge base for information"

# With partition specified
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server --partition your_partition_id

# Using both options
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server --description "Search the company knowledge base" --partition your_partition_id

Configuración de Cursor

Para usar este servidor MCP con Cursor:

Opción 1: Crear un archivo de configuración MCP

1. Guarda un archivo llamado mcp.json

• Para herramientas específicas de un proyecto, crea un archivo .cursor/mcp.json en el directorio de tu proyecto. Esto te permite definir servidores MCP que solo están disponibles dentro de ese proyecto específico.
• Para herramientas que deseas usar en todos los proyectos, crea un archivo ~/.cursor/mcp.json en tu directorio de inicio. Esto hace que los servidores MCP estén disponibles en todos tus espacios de trabajo de Cursor.

Ejemplo de mcp.json:

{
  "mcpServers": {
    "ragie": {
      "command": "npx",
      "args": [
        "-y",
        "@ragieai/mcp-server",
        "--partition",
        "optional_partition_id"
      ],
      "env": {
        "RAGIE_API_KEY": "your_api_key"
      }
    }
  }
}

Opción 2: Usar un script de shell

1. Guarda un archivo llamado ragie-mcp.sh en tu sistema:

#!/usr/bin/env bash

export RAGIE_API_KEY="your_api_key"

npx -y @ragieai/mcp-server --partition optional_partition_id

2. Otorga permisos de ejecución al archivo: chmod +x ragie-mcp.sh

3. Agrega el script del servidor MCP yendo a Configuración -> Configuración de Cursor -> Servidores MCP en la interfaz de Cursor.

Reemplaza your_api_key con tu clave API real de Ragie y opcionalmente establece el ID de partición si es necesario.

Configuración de Claude Desktop

Para usar este servidor MCP con Claude Desktop:

1. Crea el archivo de configuración MCP claude_desktop_config.json:

• Para MacOS: Usa ~/Library/Application Support/Claude/claude_desktop_config.json
• Para Windows: Usa %APPDATA%/Claude/claude_desktop_config.json

Ejemplo de claude_desktop_config.json:

{
  "mcpServers": {
    "ragie": {
      "command": "npx",
      "args": [
        "-y",
        "@ragieai/mcp-server",
        "--partition",
        "optional_partition_id"
      ],
      "env": {
        "RAGIE_API_KEY": "your_api_key"
      }
    }
  }
}

Reemplaza your_api_key con tu clave API real de Ragie y opcionalmente establece el ID de partición si es necesario.

2. Reinicia Claude Desktop para que los cambios surtan efecto.

La herramienta de recuperación de Ragie ahora estará disponible en tus conversaciones de Claude Desktop.

Características

Herramienta de recuperación

El servidor proporciona una herramienta retrieve que se puede usar para buscar en la base de conocimiento. Acepta los siguientes parámetros:

• query (cadena): La consulta de búsqueda para encontrar información relevante
• topK (número, opcional, predeterminado: 8): El número máximo de resultados a devolver
• rerank (booleano, opcional, predeterminado: true): Si intentar encontrar solo la información más relevante
• recencyBias (booleano, opcional, predeterminado: false): Si favorecer los resultados hacia información más reciente

La herramienta devuelve:

• Una matriz de fragmentos de contenido que contienen texto coincidente de la base de conocimiento

Desarrollo

Este proyecto está escrito en TypeScript y utiliza las siguientes dependencias principales:

• @modelcontextprotocol/sdk: Para implementar el servidor MCP
• ragie: Para interactuar con la API de Ragie
• zod: Para la validación de tipos en tiempo de ejecución

Configuración de desarrollo

Ejecutar el servidor en modo de desarrollo:

RAGIE_API_KEY=your_api_key npm run dev -- --partition optional_partition_id

Compilar el proyecto:

npm run build

Licencia

Licencia MIT - Consulta LICENSE.txt para más detalles.