Loads environment variables from the project's .env file to configure the InstantDB connection with essential variables like INSTANT_APP_ID and INSTANT_APP_ADMIN_TOKEN.
Provides installation instructions specific to macOS, including the file path for Claude Desktop configuration at ~/Library/Application Support/Claude/claude_desktop_config.json.
Provides npm commands for installation, building, and development of the server, including dependency management and auto-rebuild capabilities.
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.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A read-only interface for querying InstantDB that dynamically loads schemas and enables executing queries through pre-defined patterns.
Related MCP Servers
- AsecurityAlicenseAqualityAllows AI assistants to list tables, read data, and execute SQL queries through a controlled interface, making database exploration and analysis safer and more structured.Last updated -1732PythonMIT License
- AsecurityFlicenseAqualityEnables AI models to perform MySQL database operations through a standardized interface, supporting secure connections, query execution, and comprehensive schema management.Last updated -76425JavaScript
- -securityAlicense-qualityEnables LLMs to interact with MySQL databases by inspecting schemas and executing safe, read-only queries within transactions.Last updated -28JavaScriptMIT License
- AsecurityAlicenseAqualityA server that enables LLMs like Claude to query AWS DynamoDB databases through natural language requests, supporting table management, data querying, and schema analysis.Last updated -7421JavaScriptMIT License