Fireproof JSON Document Server

What is Fireproof JSON Document Server about? Provides a lightweight server that stores JSON documents using Fireproof, exposing create, read, update, delete, and sorted query capabilities through the Model Context Protocol.

How to use Fireproof JSON Document Server?

Install dependencies:
```
npm install
npm run build
```
Add the server to Claude Desktop configuration (or any MCP‑compatible client) using the path to the built index.js or, with the provided serverConfig, run via npx.
Start the server (it communicates over stdio), optionally launch the MCP Inspector for debugging:
```
npm run inspector
```

Key features of Fireproof JSON Document Server

Full CRUD API for JSON documents.
Query documents sorted by any specified field.
Built on Fireproof storage for offline‑first capabilities.
Compatible with AI systems through MCP communication.
Debuggable with the MCP Inspector tool.

Use cases of Fireproof JSON Document Server

Supplying structured data to AI assistants (e.g., Claude Desktop) for context‑aware responses.
Rapid prototyping of document‑oriented backends in AI‑driven applications.
Offline‑first data storage for local AI tools.
Simple data store for micro‑services needing JSON persistence without a full database.

FAQ from the Fireproof JSON Document Server

Do I need a separate database server? No, Fireproof handles storage locally; the MCP server simply exposes an API.
Can I customize the storage path? Yes, Fireproof allows configuration of the underlying store location via its API.
Is authentication supported? The demo does not include auth; you can wrap the server with your own authentication layer if needed.
How do I debug communication issues? Use the MCP Inspector (npm run inspector) which provides a web UI for inspecting stdio messages.
What Node.js version is required? Any recent LTS version (>=14) works.

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 JSON Document Server