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.