mi-servidor-mcp

Un proyecto de juego y experimentación para construir un servidor MCP (Model Context Protocol) usando TypeScript. Demuestra cómo exponer herramientas y recursos a agentes de IA y modelos de lenguaje a través del transporte stdio.

El servidor gestiona una base de datos simple de usuarios (respaldada por un archivo JSON local) y expone endpoints que un agente de IA puede llamar para leer o crear registros de usuarios.

Características

• Herramienta — my-create-tool: Crea un nuevo usuario aceptando los campos name, address, email y phone, y guarda el registro en src/users.json.

• Recurso — users://all: Devuelve la lista completa de usuarios de la base de datos mock como JSON.

• Recurso — users://{userId}/profile: Devuelve el perfil de un solo usuario identificado por userId.

Related MCP server: FastMCP Example Server

Requisitos previos

• Node.js v18 o posterior

• npm v9 o posterior

Instalación

npm install

Ejecutar el servidor

Modo de desarrollo (usando tsx, sin paso de compilación)

npm run server:dev

Compilar y ejecutar la salida compilada

npm run server:build   # compiles TypeScript → JavaScript
node dist/server.js    # run the compiled server

Modo de observación (recompilación automática ante cambios)

npm run server:build:watch

Inspeccionar con la interfaz de MCP Inspector

El MCP Inspector te permite llamar herramientas y explorar recursos de forma interactiva en una interfaz de navegador:

npm run server:inspect

Nota: server:inspect establece DANGEROUSLY_OMIT_AUTH=true — úsalo solo para desarrollo local.

Cargar el servidor MCP en entornos de agentes

CLI de agentes (p. ej., Claude Code CLI)

La existencia de .mcp.json debería ser detectada por el agente y se le pedirá que cargue el servidor. De lo contrario, es una configuración simple de servidor MCP que debe añadirse a la configuración junto con otros servidores.

Estructura del proyecto

my-mcp-server/
├── src/
│   ├── server.ts      # MCP server entry point (tools & resources)
│   └── users.json     # Mock user database (read/written at runtime)
├── package.json
└── tsconfig.json

Stack tecnológico

Licencia

ISC