Служба калькулятора MCP

Реализация протокола «модель-контекст-протокол» (MCP) для службы калькулятора, которая использует Claude AI для обработки запросов на естественном языке и выполнения математических вычислений.

Архитектура

Услуга состоит из трех основных компонентов:

1. API калькулятора ( calculator-api.js ): обрабатывает основные математические операции.

2. MCP Server ( mcp-server.js ): управляет интеграцией LLM и оркестровкой инструментов

3. Клиент MCP ( mcp-client.js ): предоставляет пользовательский интерфейс для взаимодействия со службой.

Related MCP server: Calculator MCP

Настраивать

1. Установить зависимости:

npm install

2. Создайте файл .env в корневом каталоге со следующими переменными:

ANTHROPIC_API_KEY=your_api_key_here
PORT=3000
MCP_PORT=3001

Запуск службы

Вы можете запустить все компоненты одновременно:

npm start

Или запустите их по отдельности:

# Calculator API
npm run start:calculator

# MCP Server
npm run start:mcp

# MCP Client
npm run start:client

Использование

После запуска сервиса вы можете взаимодействовать с ним через клиентский интерфейс. Вот несколько примеров команд:

• «Сложи 5 и 3»

• «Сколько будет 10 плюс 20?»

• «Рассчитать 7,5 + 2,25»

• «Умножь 4 на 6»

• «Сколько будет 8 умножить на 3?»

Введите «help» для получения дополнительных примеров или «exit» для выхода.

Конечные точки API

API калькулятора (порт 3000)

• POST /:operation - Выполнение математических операций (сложение, вычитание, умножение, деление, возведение в степень)

• GET /health — конечная точка проверки работоспособности

MCP-сервер (порт 3001)

• GET /tools — список доступных инструментов

• POST /execute/:toolId — Выполнить определенный инструмент

• POST /agent — Обработка запросов на естественном языке

• GET /health — конечная точка проверки работоспособности

Обработка ошибок

Услуга включает в себя комплексную обработку ошибок для:

• Недопустимые математические операции

• Деление на ноль

• Недопустимые типы параметров

• Ошибки анализа ответа LLM

• Ошибки сети

Зависимости

• @anthropic-ai/sdk: ^0.51.0

• аксиос: ^1.6.7

• парсер тела: ^1.20.2

• корс: ^2.8.5

• dotenv: ^16.4.5

• экспресс: ^4.18.3

• одновременно: ^8.2.2 (зависимость от разработки)