Model Context Protocol and Fireproof Demo: JSON Document Server

Store and load JSON documents from LLM tool use

javascript

30

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fireproof-storage-mcp-database-server": {
      "command": "/path/to/fireproof-mcp/build/index.js",
      "args": []
    }
  }
}

This MCP server provides a Fireproof-backed JSON document store with Create, Read, Update, and Delete operations, plus the ability to query and sort documents by any field. It enables you to plug a simple, persistent document store into AI systems and experiments that require structured data access.

How to use

You interact with this MCP server through a local stdio interface. Start the server locally and point your MCP client to the configured stdio command. Use the Create, Read, Update, and Delete operations to manage JSON documents, and leverage field-based queries to retrieve documents sorted by the fields you specify. This enables seamless integration with AI workflows that need a lightweight, persistent data store.

How to install

Prerequisites you need before installing:

Node.js and npm installed on your system
A suitable shell or terminal for running commands

Concrete steps to install and prepare the server are below. Run each command in your project root or a dedicated development folder.

npm install
npm build

Additional sections

Configure the MCP server for your environment and debugging conveniences.

If you are using Claude Desktop, place the server configuration file under your Claude config directory. The example below shows how to register the Fireproof MCP server as a local stdio process.

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

Debugging

MCP servers communicate over stdio, which can make debugging challenging. Use the MCP Inspector to access debugging tools in your browser. Run the inspector script to start debugging infrastructure and obtain a URL for the tools.

npm run inspector

Available tools

createDocument

Create a new JSON document in the store and return its identifier.

readDocument

Retrieve a document by its identifier or by a query criterion.

updateDocument

Modify fields of an existing document identified by its ID.

deleteDocument

Remove a document from the store by its identifier.

queryDocuments

Query and sort documents by specified fields to fetch a ranked result set.