Servidor MCP TypeScript

Um servidor de backend em TypeScript que oferece um conjunto de ferramentas através de uma API REST, construído com Node.js e Express.
O projeto inclui uma interface web interativa para utilizar as ferramentas e está configurado para deploy fácil via Docker.

---

🛠️ Ferramentas Disponíveis

Atualmente, o servidor oferece as seguintes ferramentas:

1. Contador de Palavras → Analisa um texto e retorna a frequência de cada palavra.
2. Gerador de UUID → Gera identificadores únicos universalmente (UUID v4).
3. Ferramenta de IA (Gemini) → Integra-se à API do Gemini para responder a prompts de texto.

---

🚀 Instalação e Uso

Requisitos

• Node.js (versão 18 ou superior)
• npm

Instalação

Clone o repositório e instale as dependências:

git clone <url-do-seu-repositorio>
cd <nome-do-repositorio>
npm install

Para compilar o código TypeScript e iniciar o servidor de produção:

O comando postinstall já executa o build automaticamente após npm install

npm start

O servidor estará rodando em http://localhost:3000.

Para rodar o servidor em modo de desenvolvimento com recarregamento automático (usando tsx):

npm run dev

---

🐳 Deploy no EasyPanel

Este projeto está pronto para deploy usando Docker. O arquivo easypanel.yml já está configurado.

1. Faça o push do seu código para um repositório Git (GitHub, GitLab, etc.).
2. No seu painel do EasyPanel, crie um novo serviço e aponte-o para o seu repositório.
3. O EasyPanel detectará o Dockerfile e construirá a imagem automaticamente.
4. Configure as variáveis de ambiente necessárias.

---

⚙️ Variáveis de Ambiente

Para rodar o projeto, as seguintes variáveis de ambiente são necessárias:

Variável	Descrição	Padrão
PORT	Porta em que o servidor irá rodar	3000
NODE_ENV	Ambiente da aplicação (production, development)	-
CLAUDE_API_KEY	Chave de API para o serviço Claude da Anthropic	-
CLAUDE_API_URL	URL da API do Claude	https://api.anthropic.com/v1/messages

---

📡 Endpoints da API

• GET / → Serve a interface web principal.
• GET /health → Verifica a saúde do serviço.
• GET /api/status → Retorna o status (online/offline) de cada ferramenta.
• POST /api/word-count → Recebe um texto e conta a frequência das palavras.
• POST /api/generate-uuid → Gera um ou mais UUIDs.
• POST /api/ai-tool → Envia um prompt para a IA do Claude.

---

📦 Estrutura do Projeto

.
├── Dockerfile          # Configuração do container Docker
├── easypanel.yml       # Configuração para deploy no EasyPanel
├── package.json        # Dependências e scripts do projeto
├── tsconfig.json       # Configurações do compilador TypeScript
├── public/             # Arquivos da interface web
│   ├── index.html      # Estrutura da página
│   ├── style.css       # Estilos visuais
│   └── script.js       # Lógica do lado do cliente
└── src/                # Código-fonte do servidor
    ├── controllers/    # Controladores que lidam com a lógica das requisições
    │   └── toolcontroller.ts
    ├── routes/         # Definição das rotas da API
    │   └── apiRoutes.ts
    ├── tools/          # Lógica de negócio de cada ferramenta
    │   ├── uuidGenerator.ts
    │   └── wordCounter.ts
    ├── config.ts       # Configuração de variáveis de ambiente
    └── index.ts        # Arquivo principal do servidor Express

---

🤝 Contribuindo

Sinta-se à vontade para abrir issues e enviar pull requests. Toda contribuição é bem-vinda! 🚀

---

📄 Licença

Este projeto é licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.