# 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

## Architecture

```mermaid
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

```bash
npm install
npm run build
npm start
```

Para desarrollo:

```bash
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:

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

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