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.

Related MCP server: Browser-use MCP Server

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

📡 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.