InstantDB MCP Server

@instantdb/mcp

Comece Aqui · Exemplos · Documentação · Discord

Bem-vindo ao servidor MCP do Instant.

Instant MCP

Este MCP é um wrapper em torno do SDK da Plataforma Instant. Adicione este MCP ao seu editor para criar, gerenciar e atualizar suas aplicações InstantDB.

Servidor MCP remoto

O Instant hospeda a versão mais recente do servidor em https://mcp.instantdb.com.

Para clientes modernos que suportam HTTP streamable, use https://mcp.instantdb.com/mcp.

Para clientes legados que exigem SSE, use https://mcp.instantdb.com/sse.

Para instruções mais específicas de cada editor, consulte a documentação pública.

Servidor MCP local

Se ainda não o fez, obtenha um token de acesso pessoal no seu painel do Instant.

Execute o servidor em modo stdio com npx -y @instantdb/mcp --token <token>.

Para instruções mais específicas de cada editor, consulte a documentação pública.

Contribuindo

Início Rápido

Clone este repositório e use o MCP Inspector @modelcontextprotocol/inspector para depurar e desenvolver este servidor localmente.

# Clone this repo
git clone ..

# Navigate to the cloned directory and build the MCP server
cd ..
npm run build

# Run the server
npx @modelcontextprotocol/inspector node ./dist/index.js --token <token>

# Or alternatively via environment variable
INSTANT_ACCESS_TOKEN=<token> npx @modelcontextprotocol/inspector node ./build/index.js

# You can also specify a url to connect to a local instance of your instant server
npx @modelcontextprotocol/inspector node ./dist/index.js --token <token> --api-url
http://localhost:8888

Se estiver usando o Claude Code, você pode adicionar o servidor MCP diretamente após a compilação:

claude mcp add --transport stdio instant-local -- node <path-to-your-cloned-repo>/dist/index.js --token <token>

Você pode então remover o servidor diretamente:

claude mcp remove instant-local

Você também pode configurar seu editor para se conectar ao seu MCP local. Aqui está um exemplo de configuração para MacOS/Linux:

{
  "mcpServers": {
    "instant": {
      "command": "node",
      "args": [
        "<path-to-your-cloned-repo>/dist/index.js",
        "--token",
        "<token>",
        "--api-url",
        "http://localhost:8888"
      ]
    }
  }
}

MCP Remoto

cp .env.example .env

Preencha todas as variáveis de ambiente para o seu novo arquivo .env.

pnpm run dev

Acesse o servidor em http://localhost:3123.

Para trabalhar na versão stdio do código, atualize seu arquivo .env com SERVER_TYPE=stdio.