Servicio de calculadora MCP

Una implementación de Modelo-Contexto-Protocolo (MCP) para un servicio de calculadora que utiliza Claude AI para procesar solicitudes de lenguaje natural y realizar cálculos matemáticos.

Arquitectura

El servicio consta de tres componentes principales:

1. API de calculadora ( calculator-api.js ): maneja operaciones matemáticas básicas

2. Servidor MCP ( mcp-server.js ): administra la integración de LLM y la orquestación de herramientas

3. Cliente MCP ( mcp-client.js ): proporciona una interfaz de usuario para interactuar con el servicio.

Related MCP server: MCP Math Server

Configuración

1. Instalar dependencias:

npm install

2. Cree un archivo .env en el directorio raíz con las siguientes variables:

ANTHROPIC_API_KEY=your_api_key_here
PORT=3000
MCP_PORT=3001

Ejecución del servicio

Puede ejecutar todos los componentes simultáneamente:

npm start

O ejecutarlos individualmente:

# Calculator API
npm run start:calculator

# MCP Server
npm run start:mcp

# MCP Client
npm run start:client

Uso

Una vez que el servicio esté en ejecución, puede interactuar con él a través de la interfaz de cliente. A continuación, se muestran algunos comandos de ejemplo:

• "Sumar 5 y 3"

• "¿Cuánto es 10 más 20?"

• Calcula 7,5 + 2,25

• "Multiplica 4 por 6"

• "¿Cuánto es 8 por 3?"

Escriba "ayuda" para obtener más ejemplos o "salir" para salir.

Puntos finales de API

API de calculadora (Puerto 3000)

• POST /:operation - Realiza operaciones matemáticas (sumar, restar, multiplicar, dividir, potencia)

• GET /health - Punto final de comprobación de estado

Servidor MCP (Puerto 3001)

• GET /tools - Lista de herramientas disponibles

• POST /execute/:toolId - Ejecutar una herramienta específica

• POST /agent : Procesar solicitudes en lenguaje natural

• GET /health - Punto final de comprobación de estado

Manejo de errores

El servicio incluye un manejo integral de errores para:

• Operaciones matemáticas no válidas

• División por cero

• Tipos de parámetros no válidos

• Errores de análisis de respuesta de LLM

• Errores de red

Dependencias

• @anthropic-ai/sdk: ^0.51.0

• axios: ^1.6.7

• analizador corporal: ^1.20.2

• cors: ^2.8.5

• dotenv: ^16.4.5

• expreso: ^4.18.3

• simultáneamente: ^8.2.2 (dependencia de desarrollo)