## Meu MCP

Servidor MCP mínimo em TypeScript, executado por `stdio`, para demonstrar como
expor uma ferramenta a clientes compatíveis com Model Context Protocol.

---

### Funcionalidade

O servidor disponibiliza uma ferramenta simples e validada com Zod.

- **Ferramenta:** `saudacao`
- **Entrada obrigatória:** `nome`
- **Saída:** mensagem de saudação em texto e em formato estruturado
- **Transporte:** `stdio`

Exemplo de entrada:

```json
{
  "nome": "Ada"
}
```

Exemplo de resposta:

```text
Olá, Ada! Bem-vindo ao meu servidor MCP.
```

---

### Requisitos

Dependências necessárias para desenvolver, executar e testar o projeto.

- Node.js 20 ou mais recente
- npm

---

### Instalação e compilação

Prepare as dependências e gere os arquivos JavaScript consumidos pelos
clientes MCP.

```bash
npm install
npm run build
```

---

### Execução local

Use o modo de desenvolvimento ao alterar o código ou execute a versão já
compilada.

```bash
npm run dev
```

```bash
npm start
```

O processo fica aguardando mensagens MCP pela entrada padrão. Logs devem ser
escritos em `stderr`, pois a saída padrão é reservada ao protocolo.

---

### Consumir o servidor

As configurações completas foram separadas para facilitar o uso em diferentes
clientes.

Consulte [USAGE.md](./USAGE.md) para configurar:

- MCP Inspector
- Codex
- Claude Code e Claude Desktop
- Devin

Os clientes locais iniciam o processo automaticamente. Não mantenha
`npm start` aberto quando o cliente já estiver configurado para executar o
servidor.

---

### Estrutura do projeto

Arquivos principais responsáveis pelo servidor, transporte e validação.

```text
.
├── src/
│   ├── index.ts
│   └── server.ts
├── test/
│   └── server.test.ts
├── USAGE.md
├── package.json
├── tsconfig.json
└── tsconfig.test.json
```

---

### Verificação

Valide os tipos, compile o projeto e execute o teste de integração.

```bash
npm run typecheck
npm run build
npm test
```