MCP API Engineering Lab

Servidor MCP público y genérico para demostrar cómo un agente puede recibir contexto desde una base de datos y contratos OpenAPI.

Creado desde cero para el portafolio. No contiene código, endpoints, reglas, esquemas ni credenciales de clientes.

Stack

• TypeScript

• MCP TypeScript SDK v2

• Zod

• PostgreSQL (pg)

• OpenAPI YAML

Related MCP server: openapi-mcp-proxy

Architecture

flowchart LR
    DB[(PostgreSQL)] --> MCP[MCP Server]
    OpenAPI[OpenAPI contracts] --> MCP
    MCP --> Agent[MCP-capable AI client]
    Agent --> Code[Code / API tasks]

Tools

• get_database_schema

• list_api_contracts

• get_api_contract

• create_api_contract

• update_api_contract

• delete_api_contract

Ejecutar

npm install
npm run build
npm start

Para desarrollo:

npm run dev

Base de datos

Si defines DATABASE_URL, el tool get_database_schema consulta information_schema.

Si no está definida, devuelve data/sample-schema.sql, para poder demostrar el servidor sin infraestructura externa.

OpenAPI

Los contratos viven en contracts/.

El MCP puede leer, crear, actualizar y eliminar contratos locales. template.yaml está protegido.

Cliente MCP

Configura este proyecto como servidor stdio con:

node /ruta/al/repositorio/dist/index.js

Usa la documentación de tu cliente MCP para el formato exacto de configuración.