Built with TypeScript providing complete type definitions for API interactions and data validation
Uses Zod for schema validation and type safety when processing API requests and responses
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP API Serverwhat's the weather in Tokyo tomorrow?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP API Server
Servidor MCP (Model Context Protocol) con arquitectura modular que permite conectarse a APIs externas.
Estructura del Proyecto
src/
├── config/ # Configuración
│ ├── api.ts # Configuración de API
│ └── env.ts # Variables de entorno
├── services/ # Servicios de negocio
│ ├── httpClient.ts # Cliente HTTP base
│ ├── userService.ts # Servicio de usuarios
│ ├── weatherService.ts # Servicio de clima
│ └── companyService.ts # Servicio de empresas
├── tools/ # Herramientas MCP
│ ├── weatherTool.ts # Herramienta de clima
│ ├── userCreateTool.ts # Crear usuarios
│ ├── userListTool.ts # Listar usuarios
│ ├── companyCreateTool.ts # Crear empresas
│ └── companyListTool.ts # Listar empresas
├── types/ # Tipos TypeScript
│ ├── api.ts # Tipos base de API
│ └── company.ts # Tipos de empresas
└── main.ts # Punto de entradaRelated MCP server: Node.js MCP Weather Server
Características
✅ Arquitectura modular y escalable
✅ Cliente HTTP reutilizable
✅ Validación con Zod
✅ Tipos TypeScript completos
✅ Manejo de errores robusto
✅ Configuración por variables de entorno
Herramientas Disponibles
Clima
obtener-clima: Obtiene información del clima
Usuarios
crear-usuario: Crea un nuevo usuariolistar-usuarios: Lista todos los usuarios
Empresas (API Externa)
crear-empresa: Crea una nueva empresa vía APITamaños permitidos:
small,medium,large
listar-empresas: Lista empresas desde la API
Scripts Disponibles
# Construir el proyecto
npm run build
# Ejecutar en modo desarrollo
npm run dev
# Ejecutar el servidor
npm start
# Abrir inspector MCP
npm run inspectorVariables de Entorno
API_BASE_URL=https://api.ejemplo.com # URL base de la API
API_TIMEOUT=30000 # Timeout en milisegundos
NODE_ENV=development # Entorno de ejecuciónUso con Inspector MCP
Ejecutar el inspector:
npm run inspectorEl servidor se iniciará en modo debug
Se abrirá automáticamente el navegador con la interfaz
Agregar Nuevos Servicios
Para agregar un nuevo servicio (ej: productos):
Crear tipos en
src/types/product.tsCrear servicio en
src/services/productService.tsCrear herramientas en
src/tools/productCreateTool.ts, etc.Registrar herramientas en
src/main.tsActualizar configuración si es necesario
Estructura de API Externa
El servidor está configurado para trabajar con APIs que sigan este formato:
GET Response
{
"data": [...],
"links": {
"first": "string",
"last": "string",
"prev": "string",
"next": "string"
},
"meta": {
"current_page": 0,
"from": 0,
"last_page": 0,
"per_page": 0,
"to": 0,
"total": 0
}
}POST Request
{
"field1": "value1",
"field2": "value2"
}