🚀 Modular MCP Server in TypeScript (M5L2)

This project implements a clean, granular, and modular architecture for building Model Context Protocol (MCP) servers using TypeScript and schemas with Zod.

📂 Project Structure

M5L2/
├── src/
│   ├── schemas/
│   │   ├── sumar.schema.ts      <-- Esquema Zod e inferencia de tipos para 'sumar'
│   │   └── saludar.schema.ts    <-- Esquema Zod e inferencia de tipos para 'saludar'
│   ├── tools/
│   │   ├── sumar.tool.ts        <-- Tool aislada de suma
│   │   ├── saludar.tool.ts      <-- Tool aislada de saludo
│   │   └── index.ts             <-- Registro centralizador de Tools
│   ├── server.ts                <-- Fábrica de creación y configuración del McpServer
│   └── index.ts                 <-- Punto de entrada (Bootstrapping y Transporte STDIO)
├── dist/                        <-- Código transpilado a JavaScript (generado tras 'npm run build')
├── tsconfig.json                <-- Configuración estricta de TypeScript
├── package.json                 <-- Dependencias y scripts
└── README.md

Related MCP server: MCP Server TypeScript Template

📦 Installation

Install the project dependencies by running:

npm install

🛠️ Available Scripts

• Compilation (TypeScript to JavaScript in /dist):

  npm run build

• Running the Server:

  • Development (direct TS): npm run dev

  • Production (compiled code): npm start

  💡 Note: When running over STDIO, the server stays actively waiting for JSON-RPC messages. To interact with it visually, use the Inspector.

• Testing with MCP Inspector:

  npm run inspector

🧪 How to test it with MCP Inspector?

The Inspector launches an interactive web interface that connects to the server over STDIO:

1. Compile the project (if you haven't already):

   npm run build

2. Start the Inspector:

   npm run inspector

3. Open in your browser the URL shown in the terminal (e.g. http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=...) to interactively test the sumar and saludar tools.