Servidor MCP Express

Un servidor de Protocolo de Contexto de Modelo (MCP) sin estado creado con Express y TypeScript.

Características

Implementación de servidor MCP sin estado con transporte HTTP Streamable moderno
TypeScript para seguridad de tipos
Express.js para el manejo de HTTP

Related MCP server: OpenAPI MCP Server

Requisitos

Node.js 18+
npm o hilo

Instalación

# Clone the repository (or download)
git clone https://github.com/your-username/sample-express-mcp-server.git
cd sample-express-mcp-server

# Install dependencies
npm install

Desarrollo

# Build the TypeScript code
npm run build

# Run in development mode with auto-reloading
npm run dev

# Run tests (when added)
npm test

Estructura del servidor

src/
  ├── index.ts                # Main application entry point
  └── server.ts               # MCP server definition with resource, tool, and prompt

Funcionalidad disponible

Este servidor implementa un punto final de eco simple con tres componentes MCP:

Recurso : echo://{message} - Devuelve el mensaje como un recurso
Herramienta : echo - Repite el mensaje proporcionado como una respuesta de la herramienta
Prompt : echo - Crea un mensaje de usuario con el mensaje proporcionado

Protocolo MCP

Este servidor implementa el Protocolo de Contexto de Modelo (MCP), una forma estandarizada para que los LLM interactúen con datos y funcionalidades externas. Expone un punto final de API sin estado que responde a solicitudes JSON-RPC.

Uso de la API

Envíe una solicitud POST a /mcp con una carga útil JSON-RPC:

Inicializar

curl -X POST http://localhost:3001/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {
        "roots": {
          "listChanged": true
        },
        "sampling": {}
      },
      "clientInfo": {
        "name": "ExampleClient",
        "version": "1.0.0"
      }
    }
  }'

Herramienta de eco de llamada

curl -X POST http://localhost:3001/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "echo",
      "arguments": {
        "message": "Hello, World!"
      }
    },
    "id": 1
  }'