MCP JSON Document Collection Server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Mentioned as a potential development idea for generating static websites from Claude Desktop using Firebase npm libraries.

Protocolo de contexto de modelo y demostración a prueba de fuego: Servidor de recopilación de documentos JSON

Este es un ejemplo de cómo utilizar una base de datos Fireproof en un servidor de protocolo de contexto de modelo (utilizado para conectar código y datos a sistemas de IA como Claude Desktop ).

Este servidor:

  • permite la creación de múltiples "Bases de datos de documentos JSON" (implementadas utilizando Fireproof)
  • Implementa operaciones CRUD básicas (Crear, Leer, Actualizar, Eliminar) dentro de cualquier base de datos y la capacidad de consultar documentos ordenados por cualquier campo.
  • permite compartir cualquier base de datos con otros mediante el servicio y el panel de control de Fireproof Cloud

Estado de la técnica: se basa en https://github.com/fireproof-storage/mcp-database-server : agrega múltiples bases de datos más la capacidad de sincronizar con la nube.

Ejecución del servidor

Primero, construyalo:

npm install npm build

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "json-db-collections": { "command": "<base-dir>/mcp-json-db-collection-server/build/index.js" } } }

Ejemplo de sesión de chat de Claude Desktop

Aquí hay una sesión de muestra usando Claude Desktop donde creo 3 bases de datos de documentos y las sincronizo con la nube:

1. Sesión de chat: Base de datos de elementos

humano (29 de diciembre de 2024, 15:59)

Crea una base de datos de documentos json llamada elementos

asistente (29 de diciembre de 2024, 16:00)

Te ayudaré a crear una base de datos de documentos JSON llamada "elementos".

La base de datos se ha creado correctamente. Ahora puede usarla para almacenar y administrar documentos JSON. ¿Desea agregar algún documento?

humano (29 de diciembre de 2024, 16:00)

Agregue gases nobles de la tabla periódica como documentos individuales.

asistente (29 de diciembre de 2024, 16:00)

Te ayudaré a agregar los gases nobles como documentos individuales a la base de datos de elementos. Incluiré las propiedades clave de cada gas noble.

He añadido los siete gases nobles (helio, neón, argón, criptón, xenón, radón y oganesón) a la base de datos. Para cada elemento, he incluido:

  • Nombre y símbolo
  • Número atómico y masa
  • Periodo, grupo y bloque
  • Configuración electrónica
  • Puntos de fusión y ebullición (en Kelvin)
  • Densidad (en g/cm³)

Téngase en cuenta que para Oganesson, algunas propiedades físicas están marcadas como nulas ya que es un elemento sintético con una vida media muy corta y sus propiedades no están bien determinadas experimentalmente.

¿Quieres consultar alguna información específica sobre estos gases nobles de la base de datos?

humano (29 de diciembre de 2024, 16:01)

mostrar documentos

asistente (29 de diciembre de 2024, 16:01)

Consultaré todos los documentos de la base de datos de elementos, ordenados por número atómico.

Aquí están todos los gases nobles en la base de datos, enumerados en orden de número atómico (del más alto al más bajo):

  1. Oganesón (Og) - Elemento 118
  2. Radón (Rn) - Elemento 86
  3. Xenón (Xe) - Elemento 54
  4. Criptón (Kr) - Elemento 36
  5. Argón (Ar) - Elemento 18
  6. Neón (Ne) - Elemento 10
  7. Helio (He) - Elemento 2

Cada documento contiene información detallada sobre el elemento, incluyendo su masa atómica, densidad, puntos de fusión y ebullición (si se conocen) y configuración electrónica. ¿Desea examinar alguna propiedad específica o comparar ciertos aspectos de estos elementos?

2. Sesión de chat: Base de datos de ingredientes de galletas

humano (29 de diciembre de 2024, 16:01)

Crea una base de datos de documentos JSON llamada cookie_ingredients

asistente (29 de diciembre de 2024, 16:01)

Crearé una nueva base de datos de documentos JSON llamada "cookie_ingredients".

La base de datos se ha creado correctamente. ¿Desea añadir algún ingrediente?

humano (29 de diciembre de 2024, 16:02)

Agregue los ingredientes de la receta de galletas con chispas de chocolate como documentos individuales.

asistente (29 de diciembre de 2024, 16:02)

Agregaré ingredientes comunes para las galletas con chispas de chocolate como documentos individuales con sus medidas y propiedades típicas.

He añadido todos los ingredientes esenciales para una receta clásica de galletas con chispas de chocolate. Para cada ingrediente, incluí:

  • Nombre y cantidad
  • Unidad de medida
  • Tipo (seco, húmedo, leudante, etc.)
  • Propósito en la receta
  • Posibles sustitutos
  • Medidas de peso
  • Notas importantes sobre el uso

¿Quieres consultar alguna información específica sobre estos ingredientes de la base de datos?

humano (29 de diciembre de 2024, 16:02)

Mostrar los ingredientes como tabla

asistente (29 de diciembre de 2024, 16:03)

Consultaré los ingredientes y los formatearé como una tabla de rebajas.

IngredienteCantidadUnidadTipoObjetivoPeso/Unidad
Harina para todo usotazassecoestructura120 g/taza
Mantequilla sin sal1tazagordotextura y sabor227 g/taza
Azúcar granulada¾tazaedulcorantedulzura y textura200 g/taza
Azúcar moreno¾tazaedulcorantehumedad y sabor220 g/taza
Huevos grandes2enterovinculanteestructura y riqueza50 g cada uno
extracto de vainilla1cucharillacondimentomejora del sabor5 g/cucharadita
Sal1cucharillacondimentomejora del sabor6 g/cucharadita
Bicarbonato1cucharillalevaduralevantarse y extenderse4,8 g/cucharadita
Chips de chocolate2tazasmezclasabor y textura170 g/taza

He organizado los ingredientes por tipo e incluido sus cantidades, unidades, propósitos y medidas de peso. ¿Te gustaría ver más detalles sobre ingredientes específicos?

3. Sesión de chat: Base de datos de razas de caballos

humano (29 de diciembre de 2024, 16:03)

Crea una nueva base de datos de documentos JSON llamada horse_breeds

asistente (29 de diciembre de 2024, 16:03)

Crearé una nueva base de datos de documentos JSON para razas de caballos.

La base de datos se ha creado correctamente. ¿Quieres añadir más razas de caballos?

humano (29 de diciembre de 2024, 16:03)

asistente (29 de diciembre de 2024, 16:04)

Agregaré varias razas de caballos populares con sus características clave, orígenes y usos típicos.

He añadido seis razas de caballos distintivas a la base de datos:

  1. Árabe: conocido por su resistencia y refinamiento.
  2. Pura sangre: famoso por sus carreras y su capacidad atlética.
  3. Clydesdale: un poderoso caballo de tiro
  4. Quarter Horse: el versátil caballo de ganado de Estados Unidos
  5. Frisón: un elegante caballo negro de los Países Bajos.
  6. Appaloosa: conocido por sus patrones manchados y su herencia nativa americana

Cada entrada incluye información sobre:

  • Origen y tipo
  • Rango de altura (en manos, donde 1 mano = 4 pulgadas)
  • Colores comunes
  • Características físicas
  • Usos típicos
  • Temperamento
  • Rasgos notables

¿Le gustaría ver la información presentada de una manera específica o aprender más sobre alguna raza en particular?

4. Sesión de chat: Sincronización con la nube

humano (29 de diciembre de 2024, 16:04)

lista de bases de datos de documentos json

asistente (29 de diciembre de 2024, 16:04)

Enumeraré todas las bases de datos de documentos JSON que se han creado.

Tenemos tres bases de datos de documentos JSON:

  1. razas de caballos
  2. elementos
  3. ingredientes de las galletas

Cada base de datos contiene documentos relacionados con su tema específico:

  • horse_breeds tiene información sobre diferentes razas de caballos
  • elementos contiene datos sobre los gases nobles
  • cookie_ingredients tiene detalles sobre los ingredientes de las galletas con chispas de chocolate.

¿Quieres consultar alguna información específica de estas bases de datos?

humano (29 de diciembre de 2024, 16:04)

sincronizar razas de caballos con la nube

asistente (29 de diciembre de 2024, 16:04)

Te ayudaré a conectar la base de datos horse_breeds al servicio de sincronización en la nube.

La base de datos horse_breeds se ha conectado correctamente a la nube. Puede acceder al panel de control mediante la URL proporcionada anteriormente. Esto le permitirá ver y gestionar sus datos de razas de caballos a través de la interfaz en la nube. ¿Desea sincronizar también otras bases de datos con la nube?

humano (29 de diciembre de 2024, 16:05)

mostrar URL

asistente (29 de diciembre de 2024, 16:05)

Aquí está la URL del panel de control para la base de datos horse_breeds:

https://dashboard.fireproof.storage/fp/databases/connect?endpoint=fireproof://cloud.fireproof.direct/\&localName=horse\_breeds\&remoteName=019414e1-2db0-70aa-b9a4-2e2f78a7adce

Puede utilizar esta URL para acceder y administrar los datos de razas de caballos a través de la interfaz en la nube.

humano (29 de diciembre de 2024, 16:05)

sincronizar elementos de la base de datos a la nube

asistente (29 de diciembre de 2024, 16:05)

Conectaré la base de datos de elementos al servicio de sincronización en la nube.

La base de datos de elementos se ha conectado correctamente a la nube. Puede acceder al panel de control en:

https://dashboard.fireproof.storage/fp/databases/connect?endpoint=fireproof://cloud.fireproof.direct/\&localName=elements\&remoteName=019414e1-db52-75e7-b8d0-21ce605176a7

¿Te gustaría sincronizar también la base de datos cookie_ingredients?

humano (29 de diciembre de 2024, 16:05)

asistente (29 de diciembre de 2024, 16:05)

Conectaré la base de datos cookie_ingredients al servicio de sincronización en la nube.

Aquí está la URL del panel de control para la base de datos cookie_ingredients:

https://dashboard.fireproof.storage/fp/databases/connect?endpoint=fireproof://cloud.fireproof.direct/\&localName=cookie\_ingredients\&remoteName=019414e2-1f47-72d7-bf8f-a721d29a24c7

Ahora las tres bases de datos (horse_breeds, elements y cookie_ingredients) están sincronizadas con la nube y se puede acceder a ellas a través de las URL de sus respectivos paneles.

5. Sesión de chat: Limpieza

humano (29 de diciembre de 2024, 16:06)

eliminar todas las bases de datos

asistente (29 de diciembre de 2024, 16:06)

Te ayudaré a eliminar las tres bases de datos.

Las tres bases de datos se han eliminado correctamente:

  1. razas de caballos
  2. elementos
  3. ingredientes de las galletas

Déjame verificar que ya se fueron todos.

Confirmado: no quedan bases de datos en el sistema. ¿Desea crear alguna nueva?

Convertido a Markdown gracias a : https://simonwillison.net/2024/Aug/8/convert-claude-json-to-markdown/

Ideas de desarrollo futuro

  • indicaciones
  • recursos
  • multiusuario con permisos
  • indexación
  • Generar sitios web estáticos desde Claude Desktop usando bibliotecas npm de Firebase

Desarrollo

pnpm install pnpm build pnpm run inspector # To reset, do: rm -rf ~/.fireproof /tmp/dist

~/Library/Application\ Support/Claude/claude_desktop_config.json :

{ "mcpServers": { "json-db-collections": { "command": "<base-dir>/mcp-json-db-collection-server/build/index.js" } } }

Licencia

MIT o Apache 2

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Un servidor de protocolo de contexto de modelo que permite la creación y gestión de múltiples bases de datos JSON Fireproof con operaciones CRUD, capacidades de consulta y sincronización en la nube para compartir bases de datos con otros.

  1. Running the Server
    1. Sample Claude Desktop chat session
      1. 1. Chat Session: Database of Elements
      2. 2. Chat Session: Database of Cookie Ingredients
      3. 3. Chat Session: Database of Horse Breeds
      4. 4. Chat Session: Sync to Cloud
      5. 5. Chat Session: Cleanup
    2. Future development ideas
      1. Development
        1. License
          ID: zk162p0woy