SSE Calculator

Servidor MCP SSE Calculator

Um servidor de calculadora com estado que usa Server-Sent Events (SSE) para comunicação em tempo real. Este servidor implementa o Model Context Protocol (MCP) para integração com assistentes de IA.

Recursos

• Operações de calculadora em tempo real usando SSE
• Sessões com estado para cálculos contínuos
• Histórico de todas as operações de cálculo
• Interface de calculadora baseada na web
• Integração MCP para assistentes de IA

Arquitetura

O servidor é construído usando NestJS e implementa os seguintes componentes:

• Session Service: Gerencia sessões de calculadora e estado
• Calculator Service: Executa operações de cálculo
• SSE Controller: Gerencia conexões de clientes e streaming de eventos

Começando

Pré-requisitos

• Node.js (v14 ou superior)
• npm (v6 ou superior)

Instalação

1. Clone o repositório
2. Instale as dependências:

npm install

3. Inicie o servidor:

npm run start:dev

4. Abra a interface da calculadora no seu navegador:

http://localhost:3000

Endpoints da API

Stream SSE

GET /calculator/stream

Estabelece uma conexão SSE e cria uma nova sessão de calculadora.

Calcular

POST /calculator/calculate/:sessionId

Executa uma operação de cálculo na sessão especificada.

Corpo da requisição:

{
  "operation": "add", // add, subtract, multiply, divide, clear
  "a": 5,
  "b": 3
}

Histórico

GET /calculator/history/:sessionId

Recupera o histórico de cálculos da sessão especificada.

Sessões

GET /calculator/sessions

Recupera todas as sessões de calculadora ativas.

Integração MCP

Para usar este servidor como um servidor MCP, adicione a seguinte configuração ao seu arquivo de configurações MCP:

{
  "mcpServers": {
    "remote-calculator": {
      "url": "http://localhost:3000/calculator/stream",
      "disabled": false,
      "alwaysAllow": [],
      "timeout": 60
    }
  }
}

Opções de Implantação

Para implantação em produção, você pode usar as seguintes opções:

1. Docker: Um Dockerfile é fornecido para implantação em contêiner

   • Consulte Dockerfile e docker-compose.yml para configuração

2. Smithery.ai: Implante diretamente do GitHub

   • Consulte SMITHERY_DEPLOYMENT.md para instruções detalhadas
   • Configuração fornecida em smithery.json

3. Heroku/DigitalOcean: Implantação em plataforma de nuvem

   • Consulte DEPLOYMENT.md para instruções passo a passo

4. Self-hosted: Use NGINX ou similar para terminação SSL e balanceamento de carga

Hospedando Seu Próprio Servidor MCP

Após implantar seu servidor, atualize a configuração do seu cliente MCP para apontar para sua URL hospedada:

{
  "mcpServers": {
    "remote-calculator": {
      "url": "https://your-deployed-url.com/calculator/stream",
      "disabled": false,
      "alwaysAllow": [],
      "timeout": 60
    }
  }
}

Licença

MIT