Servidor MCP Prisma | Awesome MCP Servers

Visão Geral

O Model-Context-Protocol (MCP) oferece aos LLMs uma maneira de chamar APIs e, assim, acessar sistemas externos de forma bem definida.

A Prisma fornece dois servidores MCP: um local e um remoto. Veja abaixo informações específicas sobre cada um.

Se você é um desenvolvedor trabalhando em uma máquina local e quer que seu agente de IA ajude com seus fluxos de trabalho de banco de dados, use o servidor MCP local.

Se você está construindo uma "plataforma de IA" e quer dar aos seus usuários a capacidade de gerenciar bancos de dados, use o servidor MCP remoto.

Servidor MCP remoto

Você pode iniciar o servidor MCP remoto da seguinte forma:

npx -y mcp-remote https://mcp.prisma.io/mcp

Ferramentas

Ferramentas representam as capacidades de um servidor MCP. Aqui está a lista de ferramentas expostas pelo servidor MCP remoto:

CreateBackupTool: Crie um novo backup gerenciado do Prisma Postgres.
CreateConnectionStringTool: Crie uma nova Connection String para um banco de dados Prisma Postgres com o id fornecido.
CreateRecoveryTool: Restaure um banco de dados Prisma Postgres para um novo banco de dados com o id de Backup fornecido.
DeleteConnectionStringTool: Exclua uma Connection String com o id de connection string fornecido.
DeleteDatabaseTool: Exclua um banco de dados Prisma Postgres com o id fornecido.
ListBackupsTool: Obtenha uma lista de backups disponíveis do Prisma Postgres para o id de banco de dados e id de ambiente fornecidos.
ListConnectionStringsTool: Obtenha uma lista de Connection Strings de banco de dados Prisma Postgres disponíveis para o id de banco de dados e id de ambiente fornecidos.
ListDatabasesTool: Obtenha uma lista de bancos de dados Prisma Postgres disponíveis para o workspace do usuário.
ExecuteSqlQueryTool: Execute uma consulta SQL em um banco de dados Prisma Postgres com o id fornecido.
IntrospectSchemaTool: Faça a introspecção do schema de um banco de dados Prisma Postgres com o id fornecido.

Depois de conectado ao servidor MCP remoto, você também pode sempre solicitar ao seu agente de IA "List the Prisma tools" para obter uma visão geral completa das ferramentas suportadas mais recentes.

Uso

O servidor MCP remoto da Prisma segue a configuração padrão baseada em JSON para servidores MCP. Veja como fica:

{
  "mcpServers": {
    "Prisma-Remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
    }
  }
}

[!TIP] Se você quiser experimentar o servidor MCP remoto e explorar suas capacidades, recomendamos o AI Playground da Cloudflare para isso. Adicione a URL https://mcp.prisma.io/mcp no campo de texto com o placeholder Enter MCP server URL, clique em Connect e autentique-se com o Prisma Console na janela pop-up. Depois de conectado, você pode enviar prompts ao Playground e ver quais ferramentas MCP o LLM escolhe com base nos seus prompts.

Exemplos de prompts

"Mostre-me uma lista de todos os bancos de dados na minha conta."
"Crie um novo banco de dados na região dos EUA para mim."
"Popule meu banco de dados com dados realistas, mas crie um backup antes."
"Mostre-me todos os backups disponíveis do meu banco de dados."
"Mostre-me todos os clientes e execute uma análise sobre os pedidos deles."

Servidor MCP local

Você pode iniciar o servidor MCP local da seguinte forma:

npx -y prisma mcp

[!TIP] Se você estiver usando o VS Code, pode usar o modo agente do VS Code para inserir prompts como "create Postgres database" ou "apply schema migration" diretamente no chat. O agente do VS Code lida com todas as invocações subjacentes da CLI do Prisma e chamadas de API automaticamente. Consulte nossa documentação do VS Code Agent para mais detalhes.

Ferramentas

Ferramentas representam as capacidades de um servidor MCP. Aqui está a lista de ferramentas expostas pelo servidor MCP local:

migrate-status: Verifica o status da sua migração por meio do comando prisma migrate status.
migrate-dev: Cria e executa uma migração por meio do comando prisma migrate dev --name <name>. O LLM fornecerá a opção <name>.
migrate-reset: Redefine seu banco de dados por meio do comando prisma migrate reset --force.
Prisma-Postgres-account-status: Verifica seu status de autenticação com o Prisma Console por meio do comando platform auth show --early-access.
Create-Prisma-Postgres-Database: Cria um novo banco de dados Prisma Postgres por meio do comando 'init --db --name' <name> '--region' <region> '--non-interactive'. O LLM fornecerá as opções <name> e <region>.
Prisma-Login: Autentica com o Prisma Console por meio do comando platform auth login --early-access.
Prisma-Studio: Abre o Prisma Studio por meio do comando prisma studio.

Uso

O servidor MCP local da Prisma segue a configuração padrão baseada em JSON para servidores MCP. Veja como fica:

{
  "mcpServers": {
    "Prisma-Local": {
      "command": "npx",
      "args": ["-y", "prisma", "mcp"]
    }
  }
}

Exemplos de prompts

Aqui estão alguns exemplos de prompts que você pode usar quando o servidor MCP estiver em execução:

"Faça login no Prisma Console para mim."
"Crie um banco de dados na região dos EUA."
"Crie uma nova tabela Product no meu banco de dados."

Integração em ferramentas de IA

As ferramentas de IA têm diferentes maneiras de integrar servidores MCP. Na maioria dos casos, existem arquivos de configuração dedicados nos quais você adiciona a configuração JSON acima. A configuração contém um comando para iniciar o servidor que será executado pela respectiva ferramenta para que o servidor fique disponível para seu LLM.

Nesta seção, abordamos os formatos de configuração das ferramentas de IA mais populares.

VS Code

Se o seu navegador bloquear o link, você pode configurá-lo manualmente criando um arquivo .vscode/mcp.json no seu workspace e adicionando:

{
  "servers": {
    "Prisma-Local": {
      "command": "npx",
      "args": ["-y", "prisma", "mcp"]
    },
    "Prisma-Remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
    }
  }
}

Explore recursos e fluxos de trabalho adicionais do Prisma para VS Code em nossa documentação.

Cursor

Para saber mais sobre a integração MCP do Cursor, consulte a documentação MCP do Cursor.

Adicionar via instalação com um clique

Você pode adicionar o servidor Prisma MCP ao Cursor usando a instalação com um clique clicando no seguinte link:

Isso solicitará que você abra o aplicativo Cursor no seu navegador. Depois de aberto, você será guiado para instalar o servidor Prisma MCP diretamente na sua configuração do Cursor.

Adicionar via interface de Configurações do Cursor

Ao abrir as Configurações do Cursor, você pode adicionar o servidor Prisma MCP da seguinte forma:

Selecione MCP na barra lateral de configurações
Clique em + Add new global MCP server

Adicione o trecho Prisma ao objeto JSON mcpServers:

{
  "mcpServers": {
    "Prisma-Local": {
      "command": "npx",
      "args": ["-y", "prisma", "mcp"]
    },
    "Prisma-Remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
    }
  }
}

Configuração global

Adicioná-lo por meio das configurações do Cursor Settings modificará o arquivo de configuração global ~/.cursor/mcp.json. Nesse caso, o servidor Prisma MCP estará disponível em todos os seus projetos do Cursor:

{
  "mcpServers": {
    "Prisma-Local": {
      "command": "npx",
      "args": ["-y", "prisma", "mcp"]
    },
    "Prisma-Remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
    },
    // other MCP servers
  }
}

Configuração do projeto

Se você quiser que o servidor Prisma MCP esteja disponível apenas em projetos específicos do Cursor, adicione-o à configuração do Cursor do respectivo projeto dentro do diretório .cursor na raiz do projeto:

{
  "mcpServers": {
    "Prisma-Local": {
      "command": "npx",
      "args": ["-y", "prisma", "mcp"]
    },
    "Prisma-Remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
    }
    // other MCP servers
  }
}

Windsurf

Para saber mais sobre a integração MCP do Windsurf, consulte a documentação MCP do Windsurf.

Adicionar via Windsurf MCP Plugin Store (Recomendado)

Use o plugin Prisma MCP da Windsurf MCP Plugin Store. Siga os passos aqui para adicionar o plugin Prisma MCP no Windsurf. Esta é a maneira mais simples e recomendada de adicionar o servidor Prisma MCP ao Windsurf.

Adicionar via interface de Configurações do Windsurf

Ao abrir as Configurações do Windsurf (via Windsurf - Settings > Advanced Settings or Command Palette > Open Windsurf Settings Page), você pode adicionar o servidor Prisma MCP da seguinte forma:

Selecione Cascade na barra lateral de configurações
Clique em Add Server

Adicione os trechos Prisma-Local e/ou Prisma-Remote ao objeto JSON mcpServers:

{
  "mcpServers": {
    "Prisma-Local": {
      "command": "npx",
      "args": ["-y", "prisma", "mcp"]
    },
    "Prisma-Remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
    }
  }
}

Configuração global

Adicioná-lo por meio das Configurações do Windsurf modificará o arquivo de configuração global ~/.codeium/windsurf/mcp_config.json. Alternativamente, você também pode adicioná-lo manualmente a esse arquivo:

{
  "mcpServers": {
    "Prisma-Local": {
      "command": "npx",
      "args": ["-y", "prisma", "mcp"]
    },
    "Prisma-Remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
    },
    // other MCP servers
  }
}

Warp

Você pode adicionar o Prisma MCP ao Warp como uma ferramenta globalmente disponível. Primeiro, visite suas configurações de MCP e clique em + Add. A partir daqui, você pode configurar o servidor Prisma MCP como JSON. Use as propriedades command e args para iniciar o servidor Prisma MCP como um comando de configuração. Opcionalmente, você pode configurar o Prisma para ativar na inicialização usando o sinalizador start_on_launch:

{
  "Prisma": {
    "command": "npx",
    "args": [
      "-y",
      "prisma",
      "mcp"
    ],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

Clique em Save e certifique-se de que o servidor MCP esteja em execução no painel de configurações de MCP. Em seguida, abra uma nova janela de terminal e peça ao Warp para gerenciar seu banco de dados Prisma. Ele deve acessar o servidor Prisma MCP automaticamente.

Para saber mais sobre a integração MCP do Warp, visite a documentação MCP do Warp.

Claude Code

O Claude Code é uma ferramenta de IA baseada em terminal onde você pode adicionar o servidor MCP usando o comando claud mcp add para o servidor MCP local:

claude mcp add prisma-local npx prisma mcp

ou para o servidor MCP remoto:

claude mcp add prisma-remote npx mcp-remote https://mcp.prisma.io/mcp

Saiba mais na documentação MCP do Claude Code.

Claude Desktop

Siga as instruções na documentação MCP do Claude Desktop para criar o arquivo de configuração necessário:

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

Em seguida, adicione o trecho JSON a esse arquivo de configuração:

{
  "mcpServers": {
    "Prisma-Local": {
      "command": "npx",
      "args": ["-y", "prisma", "mcp"]
    },
    "Prisma-Remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
    },
    // other MCP servers
  }
}

OpenAI Agents SDK

Aqui está um exemplo de uso dos servidores Prisma MCP em um script Python por meio do OpenAI Agents SDK:

from openai import AsyncOpenAI
from openai.types.beta import Assistant
from openai.beta import AsyncAssistantExecutor
from openai.experimental.mcp import MCPServerStdio
from openai.types.beta.threads import Message, Thread
from openai.types.beta.tools import ToolCall

import asyncio

async def main():
    # Launch both MCP servers concurrently
    async with MCPServerStdio(
        params={
            "command": "npx",
            "args": ["-y", "prisma", "mcp"]
        }
    ) as local_server, MCPServerStdio(
        params={
            "command": "npx",
            "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
        }
    ) as remote_server:
        
        # Optional: list tools from both servers
        local_tools = await local_server.list_tools()
        remote_tools = await remote_server.list_tools()
        print("Local server tools:", [tool.name for tool in local_tools])
        print("Remote server tools:", [tool.name for tool in remote_tools])

        # Set up the assistant with both MCP servers
        agent = Assistant(
            name="Prisma Assistant",
            instructions="Use the Prisma tools to help the user with database tasks.",
            mcp_servers=[local_server, remote_server],
        )

        executor = AsyncAssistantExecutor(agent=agent)

        # Create a thread and send a message
        thread = Thread(messages=[Message(role="user", content="Create a new user in the database")])
        response = await executor.run(thread=thread)

        print("Agent response:")
        for message in response.thread.messages:
            print(f"{message.role}: {message.content}")

# Run the async main function
asyncio.run(main())

Certificado pela MCP Review

Prisma MCP

Documentação

Visão Geral

Servidor MCP remoto

Ferramentas

Uso

Exemplos de prompts

Servidor MCP local

Ferramentas

Uso

Exemplos de prompts

Integração em ferramentas de IA

VS Code

Cursor

Adicionar via instalação com um clique

Adicionar via interface de Configurações do Cursor

Configuração global

Configuração do projeto

Windsurf

Adicionar via Windsurf MCP Plugin Store (Recomendado)

Adicionar via interface de Configurações do Windsurf

Configuração global

Warp

Claude Code

Claude Desktop

OpenAI Agents SDK