Fireproof Demo JSON Document Server

What is Fireproof Demo JSON Document Server about?

A lightweight server that stores and loads JSON documents using a Fireproof database. It exposes Create, Read, Update, Delete (CRUD) endpoints and allows queries that return documents sorted by any specified field.

How to use Fireproof Demo JSON Document Server?

Install dependencies
```
npm install
npm run build
```
Configure Claude Desktop (or any MCP client) Add an entry to the claude_desktop_config.json file:
```
{
  "mcpServers": {
    "fireproof": {
      "command": "<path‑to>/fireproof-mcp/build/index.js"
    }
  }
}
```
Replace <path‑to> with the absolute location of the built script.
Run the server
```
node ./build/index.js
```
Debugging Use the MCP Inspector for easier debugging:
```
npm run inspector
```
The inspector will output a URL you can open in a browser.

Key features of Fireproof Demo JSON Document Server

Full CRUD functionality for JSON documents.
Dynamic sorting: query results can be ordered by any document field.
Fireproof storage: leverages the Fireproof library for on‑device persistence.
MCP‑compatible: communicates over stdio, making it plug‑and‑play with any MCP client.
Built‑in debugging: optional inspector script for real‑time inspection.

Use cases of Fireproof Demo JSON Document Server

Storing user preferences or session data for AI‑driven applications.
Providing a simple backend for prototyping AI agents that need persistent state.
Acting as a local data layer for Claude Desktop extensions.
Rapidly mocking a document‑oriented API during development.

FAQ from the Fireproof Demo JSON Document Server

Q: Do I need a separate database server? A: No. Fireproof runs locally and stores data in the file system.

Q: Can I deploy this to a cloud environment? A: Yes, as long as the environment supports Node.js and allows stdio communication.

Q: How is data persisted? A: Fireproof writes JSON documents to a local file‑based store, surviving restarts.

Q: Is authentication supported? A: The demo does not include authentication; you would need to add it in a wrapper if required.

Q: What version of Node.js is required? A: Node.js 14+ is recommended.

Model Context Protocol and Fireproof Demo: JSON Document Server

This is a simple example of how to use a Fireproof database in a Model Context Protocol server (used for plugging code and data into A.I. systems such as Claude Desktop).

This demo server implements a basic JSON document store with CRUD operations (Create, Read, Update, Delete) and the ability to query documents sorted by any field.

Installation

Install dependencies:

npm install
npm build

Running the Server

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fireproof": {
      "command": "/path/to/fireproof-mcp/build/index.js"
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Fireproof Demo JSON Document Server