# 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:

```bash
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`

```bash
npm start
```

O servidor estará rodando em [http://localhost:3000](http://localhost:3000).

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

```bash
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](LICENSE) para mais detalhes.