instantdb-server MCP Server

An MCP server for interacting with InstantDB.

This server provides a read-only interface for querying InstantDB using a dynamically loaded schema and environment configuration. It includes tools to execute queries and retrieve query examples based on pre-defined patterns.

Features

Tools

• get_examples
  Returns pre-defined example queries for various categories (e.g., "basic_read", "filtering", "associations").
• queryDB
  Executes a specific query against InstantDB. Requires a query and a descriptive name parameter.
• list_queries
  Retrieves the history of executed queries with details such as query ID, name, timestamp, and structure.
• return_query
  Retrieves a specific query by its unique ID for later reference or implementation.

Schema and Environment Integration

• Dynamic loading of the InstantDB schema from common file locations relative to a provided project directory (e.g., instant.schema.ts, src/instant.schema.ts, app/instant.schema.ts).
• Environment variable configuration is loaded from the project’s .env file. Essential variables include:
  • INSTANT_APP_ID
  • INSTANT_APP_ADMIN_TOKEN

Pending Features

• Dynamic detection of the InstantDB permissions file from common file locations.

Development

Install dependencies:

Build the server:

For development with auto-rebuild:

Installation

To use the server with Claude Desktop, add the following configuration to your Claude Desktop settings:

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

Example configuration:

Debugging

For debugging MCP server communications, use the MCP Inspector:

The Inspector will provide a URL to access tools for monitoring MCP server operations.