Servidor MCP InstantDB | Awesome MCP Servers

Servidor MCP instantdb-server

Um servidor MCP para interagir com InstantDB.

Este servidor fornece uma interface somente leitura para consultar InstantDB usando um esquema carregado dinamicamente e configuração de ambiente. Inclui ferramentas para executar consultas e recuperar exemplos de consultas com base em padrões predefinidos.

Recursos

Ferramentas

get_examples
Retorna exemplos de consultas predefinidos para várias categorias (ex.: "basic_read", "filtering", "associations").
queryDB
Executa uma consulta específica contra InstantDB. Requer um parâmetro query e um parâmetro descritivo name.
list_queries
Recupera o histórico de consultas executadas com detalhes como ID da consulta, nome, timestamp e estrutura.
return_query
Recupera uma consulta específica pelo seu ID único para referência ou implementação posterior.

Integração de Esquema e Ambiente

Carregamento dinâmico do esquema InstantDB a partir de locais de arquivo comuns relativos a um diretório de projeto fornecido (ex.: instant.schema.ts, src/instant.schema.ts, app/instant.schema.ts).
A configuração de variáveis de ambiente é carregada do arquivo .env do projeto. Variáveis essenciais incluem:
- INSTANT_APP_ID
- INSTANT_APP_ADMIN_TOKEN

Recursos Pendentes

Detecção dinâmica do arquivo de permissões InstantDB a partir de locais de arquivo comuns.

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Instalação

Para usar o servidor com Claude Desktop, adicione a seguinte configuração às configurações do Claude Desktop:

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

Exemplo de configuração:

{
  "mcpServers": {
    "instantdb-server": {
      "command": "node",
      "args": ["/path/to/instantdb-server/build/index.js"],
      "env": {
        "INSTANT_APP_ID": "your_app_id",
        "INSTANT_APP_ADMIN_TOKEN": "your_admin_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Depuração

Para depurar as comunicações do servidor MCP, use o MCP Inspector:

npm run inspector

O Inspector fornecerá uma URL para acessar ferramentas de monitoramento das operações do servidor MCP.

InstantDB

Documentação