Servidor MCP de Prisma | Awesome MCP Servers

Resumen

El Model-Context-Protocol (MCP) proporciona a los LLM una forma de llamar APIs y así acceder a sistemas externos de manera bien definida.

Prisma ofrece dos servidores MCP: uno local y otro remoto. Consulta a continuación la información específica de cada uno.

Si eres un desarrollador que trabaja en una máquina local y quieres que tu agente de IA te ayude con tus flujos de trabajo de bases de datos, usa el servidor MCP local.

Si estás construyendo una "plataforma de IA" y quieres dar a tus usuarios la capacidad de gestionar bases de datos, usa el servidor MCP remoto.

Servidor MCP remoto

Puedes iniciar el servidor MCP remoto de la siguiente manera:

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

Herramientas

Las herramientas representan las capacidades de un servidor MCP. Esta es la lista de herramientas expuestas por el servidor MCP remoto:

CreateBackupTool: Crear una nueva copia de seguridad gestionada de Prisma Postgres.
CreateConnectionStringTool: Crear una nueva cadena de conexión para una base de datos Prisma Postgres con el id dado.
CreateRecoveryTool: Restaurar una base de datos Prisma Postgres a una nueva base de datos con el id de copia de seguridad dado.
DeleteConnectionStringTool: Eliminar una cadena de conexión con el id de cadena de conexión dado.
DeleteDatabaseTool: Eliminar una base de datos Prisma Postgres con el id dado.
ListBackupsTool: Obtener una lista de copias de seguridad disponibles de Prisma Postgres para el id de base de datos y el id de entorno dados.
ListConnectionStringsTool: Obtener una lista de cadenas de conexión disponibles de bases de datos Prisma Postgres para el id de base de datos y el id de entorno dados.
ListDatabasesTool: Obtener una lista de bases de datos Prisma Postgres disponibles para el espacio de trabajo del usuario.
ExecuteSqlQueryTool: Ejecutar una consulta SQL en una base de datos Prisma Postgres con el id dado.
IntrospectSchemaTool: Inspeccionar el esquema de una base de datos Prisma Postgres con el id dado.

Una vez que estés conectado al servidor MCP remoto, también puedes pedir siempre a tu agente de IA que "Enumere las herramientas de Prisma" para obtener una visión general completa de las herramientas compatibles más recientes.

Uso

El servidor MCP remoto de Prisma sigue la configuración estándar basada en JSON para servidores MCP. Así es como se ve:

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

[!TIP] Si quieres probar el servidor MCP remoto y explorar sus capacidades, te recomendamos el AI Playground de Cloudflare para ello. Añade la URL https://mcp.prisma.io/mcp en el campo de texto con el marcador de posición Enter MCP server URL, haz clic en Connect y luego autentícate con la Prisma Console en la ventana emergente. Una vez conectado, puedes enviar indicaciones al Playground y ver qué herramientas MCP elige el LLM según tus indicaciones.

Indicaciones de ejemplo

"Muéstrame una lista de todas las bases de datos en mi cuenta."
"Crea una nueva base de datos en la región de EE. UU. para mí."
"Siembra mi base de datos con datos de apariencia real pero crea una copia de seguridad antes."
"Muéstrame todas las copias de seguridad disponibles de mi base de datos."
"Muéstrame todos los clientes y ejecuta un análisis sobre sus pedidos."

Servidor MCP local

Puedes iniciar el servidor MCP local de la siguiente manera:

npx -y prisma mcp

[!TIP] Si usas VS Code, puedes usar el modo agente de VS Code para ingresar indicaciones como "crear base de datos Postgres" o "aplicar migración de esquema" directamente en el chat. El agente de VS Code maneja todas las invocaciones subyacentes de la CLI de Prisma y las llamadas API automáticamente. Consulta nuestra documentación del agente de VS Code para más detalles.

Herramientas

Las herramientas representan las capacidades de un servidor MCP. Esta es la lista de herramientas expuestas por el servidor MCP local:

migrate-status: Verifica tu estado de migración mediante el comando prisma migrate status.
migrate-dev: Crea y ejecuta una migración mediante el comando prisma migrate dev --name <name>. El LLM proporcionará la opción <name>.
migrate-reset: Restablece tu base de datos mediante el comando prisma migrate reset --force.
Prisma-Postgres-account-status: Verifica tu estado de autenticación con la Prisma Console mediante el comando platform auth show --early-access.
Create-Prisma-Postgres-Database: Crea una nueva base de datos Prisma Postgres mediante el comando 'init --db --name' <name> '--region' <region> '--non-interactive'. El LLM proporcionará las opciones <name> y <region>.
Prisma-Login: Autentica con la Prisma Console mediante el comando platform auth login --early-access.
Prisma-Studio: Abre Prisma Studio mediante el comando prisma studio.

Uso

El servidor MCP local de Prisma sigue la configuración estándar basada en JSON para servidores MCP. Así es como se ve:

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

Indicaciones de ejemplo

Aquí hay algunas indicaciones de ejemplo que puedes usar cuando el servidor MCP esté en ejecución:

"Inicia sesión en la Prisma Console."
"Crea una base de datos en la región de EE. UU."
"Crea una nueva tabla Product en mi base de datos."

Integración en herramientas de IA

Las herramientas de IA tienen diferentes formas de integrar servidores MCP. En la mayoría de los casos, hay archivos de configuración dedicados en los que agregas la configuración JSON anterior. La configuración contiene un comando para iniciar el servidor que será ejecutado por la herramienta respectiva para que el servidor esté disponible para su LLM.

En esta sección, cubrimos los formatos de configuración de las herramientas de IA más populares.

VS Code

Si tu navegador bloquea el enlace, puedes configurarlo manualmente creando un archivo .vscode/mcp.json en tu espacio de trabajo y agregando:

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

Explora características y flujos de trabajo adicionales de Prisma para VS Code en nuestra documentación.

Cursor

Para obtener más información sobre la integración MCP de Cursor, consulta la documentación MCP de Cursor.

Agregar mediante instalación de un clic

Puedes agregar el servidor MCP de Prisma a Cursor usando la instalación de un clic haciendo clic en el siguiente enlace:

Esto te pedirá abrir la aplicación Cursor en tu navegador. Una vez abierta, se te guiará para instalar el servidor MCP de Prisma directamente en tu configuración de Cursor.

Agregar mediante la interfaz de configuración de Cursor

Al abrir la Configuración de Cursor, puedes agregar el servidor MCP de Prisma de la siguiente manera:

Selecciona MCP en la barra lateral de configuración
Haz clic en + Add new global MCP server

Agrega el fragmento Prisma al 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"]
    }
  }
}

Configuración global

Agregarlo mediante la Configuración de Cursor modificará el archivo de configuración global ~/.cursor/mcp.json. En este caso, el servidor MCP de Prisma estará disponible en todos tus proyectos de 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
  }
}

Configuración de proyecto

Si quieres que el servidor MCP de Prisma esté disponible solo en proyectos específicos de Cursor, agrégalo a la configuración de Cursor del proyecto respectivo dentro del directorio .cursor en la raíz del proyecto:

{
  "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 obtener más información sobre la integración MCP de Windsurf, consulta la documentación MCP de Windsurf.

Agregar mediante la tienda de complementos MCP de Windsurf (Recomendado)

Usa el complemento Prisma MCP de la tienda de complementos MCP de Windsurf. Sigue los pasos aquí para agregar el complemento Prisma MCP en Windsurf. Esta es la forma más simple y recomendada de agregar el servidor MCP de Prisma a Windsurf.

Agregar mediante la interfaz de configuración de Windsurf

Al abrir la Configuración de Windsurf (mediante Windsurf - Settings > Advanced Settings o Command Palette > Open Windsurf Settings Page), puedes agregar el servidor MCP de Prisma de la siguiente manera:

Selecciona Cascade en la barra lateral de configuración
Haz clic en Add Server

Agrega los fragmentos Prisma-Local y/o Prisma-Remote al 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"]
    }
  }
}

Configuración global

Agregarlo mediante la Configuración de Windsurf modificará el archivo de configuración global ~/.codeium/windsurf/mcp_config.json. Alternativamente, también puedes agregarlo manualmente a ese archivo:

{
  "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

Puedes agregar el MCP de Prisma a Warp como una herramienta disponible globalmente. Primero, visita tu configuración de MCP y haz clic en + Add. Desde aquí, puedes configurar el servidor MCP de Prisma como JSON. Usa las propiedades command y args para iniciar el servidor MCP de Prisma como un comando de configuración. Opcionalmente, puedes configurar Prisma para que se active al inicio usando la bandera start_on_launch:

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

Presiona Save y asegúrate de que el servidor MCP esté en ejecución desde tu panel de configuración de MCP. Luego, abre una nueva ventana de terminal y pide a Warp que gestione tu base de datos de Prisma. Debería alcanzar automáticamente el servidor MCP de Prisma.

Para obtener más información sobre la integración MCP de Warp, visita la documentación MCP de Warp.

Claude Code

Claude Code es una herramienta de IA basada en terminal donde puedes agregar el servidor MCP usando el comando claud mcp add para el servidor MCP local:

claude mcp add prisma-local npx prisma mcp

o para el servidor MCP remoto:

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

Obtén más información en la documentación MCP de Claude Code.

Claude Desktop

Sigue las instrucciones en la documentación MCP de Claude Desktop para crear el archivo de configuración requerido:

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

Luego agrega el fragmento JSON a ese archivo de configuración:

{
  "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

Aquí hay un ejemplo de uso de los servidores MCP de Prisma en un script de Python mediante el 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 por MCP Review

Prisma MCP

Documentación

Resumen

Servidor MCP remoto

Herramientas

Uso

Indicaciones de ejemplo

Servidor MCP local

Herramientas

Uso

Indicaciones de ejemplo

Integración en herramientas de IA

VS Code

Cursor

Agregar mediante instalación de un clic

Agregar mediante la interfaz de configuración de Cursor

Configuración global

Configuración de proyecto

Windsurf

Agregar mediante la tienda de complementos MCP de Windsurf (Recomendado)

Agregar mediante la interfaz de configuración de Windsurf

Configuración global

Warp

Claude Code

Claude Desktop

OpenAI Agents SDK