Skip to main content
Glama
rsutana

rocks-db

by rsutana

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

Related MCP server: DB MCP Server

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:

Herramienta

Propósito

Requisitos

execute_read

Ejecutar consultas SELECT

auth_token, db_type

execute_write

Ejecutar INSERT/UPDATE/DELETE

auth_token (solo administrador), db_type

list_tables

Listar todas las tablas

auth_token, db_type

describe_table

Mostrar columnas de una tabla

auth_token, db_type, table_name


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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables secure interaction with MySQL databases through SQL queries, supporting read-only operations without approval and write operations with user confirmation.
    6 npm
    ISC
  • A
    license
    A
    quality
    D
    maintenance
    Enables executing SQL queries, schema introspection, and data management for PostgreSQL and MySQL databases via natural language, supporting local, SSH, and AWS RDS connections.
    8
    145 npm
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    Enables read-only exploration and querying of PostgreSQL or MySQL databases via MCP, with schema discovery, safe SQL validation, natural language to SQL conversion, and CSV export.
    11
    1
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables secure SQL query execution on MySQL databases with authentication and permission control, allowing users to explore database tables and run read-only queries.
    -