What is Fireproof?

Fireproof is an immutable ledger database designed for live synchronization and integration with Model Context Protocol (MCP) servers. It provides a simple JSON document storage system with CRUD operations and advanced querying capabilities.

How to use Fireproof?

1. Clone the repository and install dependencies: npm install
2. Build the project: npm build
3. Configure the server in Claude Desktop's config file (paths provided in README)
4. Use MQ inspector for debugging with npm run inspector

Key features of Fireproof?

• Immutable ledger database architecture
• Live synchronization capabilities
• JSON document storage with CRUD operations
• Advanced document querying and sorting
• MCP server integration (compatible with Claude Desktop)

Use cases of Fireproof?

1. Building custom data storage solutions for AI systems
2. Creating secure, tamper-evident ledger applications
3. Developing prototype systems requiring persistent document storage
4. Implementing custom data backends for AI chat applications

FAQ from Fireproof?

• What is the relationship between Fireproof and MCP?

Fireproof is implemented as an MCP server for integration with AI systems like Claude Desktop.

• How does the immutable nature affect data management?

The immutable ledger ensures data integrity and provides an audit trail, but requires careful planning for versioned updates.

• Can I use Fireproof without Claude Desktop?

Yes, the database can be used independently, though the example showcases its MCP server functionality.

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.