Servidor MCP de SQLite

Descripción general

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que proporciona interacción con bases de datos y capacidades de inteligencia empresarial mediante SQLite. Este servidor permite ejecutar consultas SQL, analizar datos empresariales y generar automáticamente memorandos de información empresarial.

Instalación

1. Instala Bun si aún no lo has hecho
2. Clonar este repositorio
3. Instalar dependencias:
   bun install
4. Ejecute el script de instalación para configurar el servidor en Claude Desktop:
   bun run setup

El script de configuración agregará automáticamente la configuración del servidor a su archivo de configuración de Claude Desktop, ubicado en:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Componentes

Recursos

El servidor expone un único recurso dinámico:

• memo://insights : un memorando de información empresarial que se actualiza continuamente y que recopila información descubierta durante el análisis.
  • Se actualiza automáticamente a medida que se descubren nuevos conocimientos a través de la herramienta de anexar conocimientos.

Indicaciones

El servidor proporciona un mensaje de demostración:

• mcp-demo : mensaje interactivo que guía a los usuarios a través de las operaciones de la base de datos
  • Argumento requerido: topic - El dominio empresarial a analizar
  • Genera esquemas de bases de datos apropiados y datos de muestra
  • Guía a los usuarios a través del análisis y la generación de conocimientos.
  • Se integra con el memorando de información empresarial

Herramientas

El servidor ofrece seis herramientas principales:

Herramientas de consulta

• read-query
  • Ejecutar consultas SELECT para leer datos de la base de datos
  • Aporte:
    • query (cadena): La consulta SQL SELECT que se ejecutará
  • Devuelve: Resultados de la consulta como una matriz de objetos
• write-query
  • Ejecutar consultas INSERT, UPDATE o DELETE
  • Aporte:
    • query (cadena): La consulta de modificación de SQL
  • Devoluciones: { affected_rows: number }
• create-table
  • Crear nuevas tablas en la base de datos
  • Aporte:
    • query (cadena): instrucción SQL CREATE TABLE
  • Devuelve: Confirmación de creación de la tabla

Herramientas de esquema

• list-tables
  • Obtener una lista de todas las tablas en la base de datos
  • No se requiere entrada
  • Devuelve: Matriz de nombres de tablas
• describe-table
  • Ver información del esquema para una tabla específica
  • Aporte:
    • table_name (cadena): Nombre de la tabla a describir
  • Devuelve: Matriz de definiciones de columnas con nombres y tipos

Herramientas de análisis

• append-insight
  • Agregue nuevos conocimientos comerciales al recurso de notas
  • Aporte:
    • insight (cadena): información empresarial obtenida a partir del análisis de datos
  • Devoluciones: Confirmación de la adición de información
  • Activa la actualización del recurso memo://insights

Desarrollo

Estructura del proyecto

• src/index.ts : Implementación del servidor principal
• src/logger.ts : Utilidad de registro
• scripts/setup.ts : script de configuración de Claude Desktop

Explotación florestal

El servidor mantiene registros detallados en:

• server.log : Ubicado en el directorio raíz del proyecto
• Los registros incluyen marcas de tiempo, niveles de registro (DEBUG, INFO, WARN, ERROR, FATAL) y metadatos estructurados

Base de datos

El archivo de base de datos SQLite se crea en:

• data.sqlite : Ubicado en el directorio raíz del proyecto
• Se crea automáticamente si no existe

Scripts disponibles

• bun run setup : Configurar el servidor en Claude Desktop
• bun run lint : Ejecutar comprobaciones de ESLint
• bun run lint:fix : corrige problemas de ESLint automáticamente
• bun run inspect : ejecuta el inspector MCP

Licencia

Este servidor MCP está licenciado bajo la licencia MIT. Consulte el archivo de licencia para obtener más información.