Guía de configuración: Servidor MCP Fullscale Rocks

Esta guía explica cómo instalar, configurar e iniciar el servidor MCP para la base de datos fullscale-rocks.

1. Instalación

Si aún no lo has hecho, instala las dependencias:

cd rocks-mcp
npm install

2. Configuración

El servidor requiere credenciales de base de datos y una clave pública OAuth.

Configuración de la base de datos

Crea o edita rocks-mcp/.env:

MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_DATABASE=employee
MYSQL_USER=employee
MYSQL_PASSWORD=thisisapassword

PG_HOST=127.0.0.1
PG_PORT=5432
PG_DATABASE=employee
PG_USER=employee
PG_PASSWORD=thisisapassword

SSE_PORT=3001

Autenticación

El servidor busca automáticamente la clave pública OAuth en: /home/ryscript/fullscale-rocks/rocks-api/storage/oauth-public.key

Asegúrate de que este archivo exista, ya que se utiliza para verificar los tokens JWT de rocks-api.

3. Ejecución del servidor

Modo de desarrollo

Ejecuta el servidor con tsx (se recarga ante cambios en los archivos):

npm run dev

Modo de producción

Compila el código TypeScript e inicia la versión compilada:

npm run build
npm start

4. Conexión a aplicaciones de IA

Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "rocks-db": {
      "command": "node",
      "args": ["/home/ryscript/fullscale-rocks/rocks-mcp/build/index.js"]
    }
  }
}

Cliente MCP genérico (SSE)

El servidor también admite Server-Sent Events (SSE) para clientes remotos o basados en web.

• URL de SSE: http://localhost:3001/sse

• URL de envío de mensajes: http://localhost:3001/message

Puedes usar esto con el MCP Inspector u otros clientes compatibles con SSE.

5. Referencia de herramientas

El servidor expone las siguientes herramientas:

Nota: El auth_token debe ser un token Bearer válido obtenido del proceso de inicio de sesión de rocks-api.