@christopher_dondici/mcp-gen 2.1.2

package/README.pt-BR.md

@@ -0,0 +1,320 @@
+# MCP-Generator
+
+> **Também disponível em:** [English (English Version)](README.md)
+
+Gere servidores MCP a partir de specs OpenAPI.
+
+> **Status**: `@christopher_dondici/mcp-gen` 2.1.2 está preparado para release e ainda não foi publicado no npm. Esta versão inclui correções de build, empacotamento, CI e dependências, sem novas funcionalidades de runtime. Use o início rápido pelo código-fonte abaixo. Veja as [notas de release](RELEASE_NOTES.md).
+
+`mcp-gen` transforma uma spec OpenAPI v3 em um servidor [Model Context Protocol](https://modelcontextprotocol.io) em TypeScript, Python ou Go. Cada rota vira uma tool, e a geração incremental preserva o código customizado entre os marcadores indicados.
+
+
+## Início rápido
+
+Com Git, Node.js 20+ e npm 9+ instalados, execute:
+
+```bash
+git clone https://github.com/ChristopherDond/MCP-Generator.git
+cd MCP-Generator
+npm ci
+npm run build
+node dist/cli/index.js --version
+```
+
+Gerar um servidor a partir de uma spec local:
+
+```bash
+node dist/cli/index.js generate -i examples/petstore.yaml -l typescript -o ./my-server
+```
+
+Validar uma spec sem gerar arquivos:
+
+```bash
+node dist/cli/index.js validate -i examples/petstore.yaml
+```
+
+Execute esses comandos na raiz do repositório, na branch `main`. As correções de build e empacotamento fazem parte da 2.1.2. A geração cria um scaffold; não instala dependências, compila ou inicia o servidor gerado.
+
+Use a CLI interativa se preferir prompts:
+
+```bash
+npm run dev
+```
+
+## O que a ferramenta faz
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant CLI
+    participant Parser
+    participant Generator
+    participant Output
+
+    User->>CLI: mcp-gen generate --input api.yaml --lang python
+    CLI->>Parser: valida e faz parse de OpenAPI v3 (JSON ou YAML)
+    Parser->>Generator: AST interna (tools, models, examples)
+    Generator->>Output: renderiza templates Handlebars
+    Output-->>User: projeto MCP em TypeScript, Python ou Go
+```
+
+Cada rota vira uma tool MCP com:
+
+- entrada tipada a partir de parâmetros e request body
+- respostas de exemplo da spec
+- preservação opcional de código incremental
+
+## Requisitos
+
+- Node.js 20+
+- npm 9+ (o início rápido usa o lockfile do repositório)
+- Git para clonar o repositório
+- (Opcional) Python 3.8+ para projetos Python
+- (Opcional) Go 1.22+ para projetos Go
+
+## Instalação local e comandos abreviados
+
+Use o build do código-fonte em [Início rápido](#início-rápido) enquanto a publicação no npm não estiver verificada. Quando a versão 2.1.2 for publicada e sua disponibilidade no npm for confirmada, você poderá instalá-la com `npm install -g @christopher_dondici/mcp-gen@2.1.2`.
+Neste README, `mcp-gen` é uma abreviação de `node dist/cli/index.js`, executado na raiz do repositório. Por exemplo, `mcp-gen validate -i examples/petstore.yaml` equivale a `node dist/cli/index.js validate -i examples/petstore.yaml`.
+
+Opcionalmente, execute `npm link` na raiz após o build para disponibilizar o comando `mcp-gen` apontando para seu checkout local. Isso altera os links globais do npm; não baixa um pacote `@christopher_dondici/mcp-gen` publicado. O nome npm mudou porque `mcp-gen` foi recusado por similaridade com `mcpgen`; o comando continua sendo `mcp-gen`.
+
+Para instalar um tarball produzido localmente sem publicar:
+
+```bash
+npm install ./christopher_dondici-mcp-gen-2.1.2.tgz
+./node_modules/.bin/mcp-gen --version
+./node_modules/.bin/mcp-gen validate -i node_modules/@christopher_dondici/mcp-gen/examples/petstore.yaml
+```
+
+## CLI
+
+### Comandos
+
+- `mcp-gen generate` ou `mcp-gen g` cria um servidor a partir de uma spec.
+- `mcp-gen validate` ou `mcp-gen v` confere uma spec sem gerar arquivos.
+- `mcp-gen init` baixa uma spec pública conhecida e pode gerar um projeto.
+- `mcp-gen watch` observa um arquivo ou URL e regenera quando houver mudança.
+
+### Gerar
+
+```bash
+mcp-gen generate -i ./api/openapi.yaml -l typescript -o ./my-server
+mcp-gen generate -i ./api/openapi.yaml -l python -o ./my-server
+```
+
+Flags úteis:
+
+- `--force`, `-f` sobrescreve arquivos existentes.
+- `--incremental` mantém o código entre `@@mcp-gen:start` e `@@mcp-gen:end`.
+- `--name <name>` define o nome do servidor.
+- `--server-version <version>` define a versão do servidor.
+- `--plugin <path>` carrega um plugin.
+
+### Validar
+
+```bash
+mcp-gen validate -i ./api/openapi.yaml
+```
+
+Formatos aceitos: `.json`, `.yaml`, `.yml` ou uma URL.
+
+### Segurança e lint (v2.1.1)
+
+```bash
+node dist/cli/index.js security -p ./my-server
+node dist/cli/index.js security -p ./my-server --fail-on-warn
+```
+
+Analisa arquivos gerados buscando padrões semelhantes a credenciais, identificadores ligados à autorização, nomes, descrições e marcadores incrementais. `--json` imprime um relatório JSON, mas a CLI também imprime um cabeçalho; stdout não é um documento JSON puro. Erros resultam em código de saída 1; `--fail-on-warn` também falha com avisos. É análise estática, não garantia de segurança.
+
+### Init
+
+`init` usa o registry interno:
+
+```bash
+mcp-gen init --from list
+mcp-gen init --from stripe
+mcp-gen init --from stripe --generate -o ./stripe-mcp
+```
+
+Chaves disponíveis no registry:
+
+| Chave | Descrição |
+|-----|-------------|
+| `stripe` | Stripe Payment API |
+| `github` | GitHub REST API |
+| `slack` | Slack Web API |
+| `openai` | OpenAI API |
+| `petstore` | Exemplo Swagger Petstore |
+| `twilio` | Twilio Communications API |
+| `shopify` | Shopify Admin API |
+| `kubernetes` | Kubernetes API |
+| `digitalocean` | DigitalOcean API |
+| `azure` | Azure Resource Manager API |
+
+### Watch
+
+```bash
+mcp-gen watch -i ./api/openapi.yaml -o ./my-server
+mcp-gen watch -i https://example.com/spec.json --interval 60000
+```
+
+Para entradas via URL, `--interval <ms>` controla o polling. `--once` gera uma vez e encerra após a primeira mudança.
+
+## Plugins
+
+Plugins podem sobrescrever templates e registrar helpers extras do Handlebars.
+
+Estrutura básica:
+
+- `templates/typescript/...` ou `templates/python/...` para sobrescrever templates `.hbs`
+- `index.js` que exporta `registerHandlebars(handlebars)` para helpers customizados
+
+Exemplo:
+
+```bash
+mcp-gen generate -i ./api/openapi.yaml --plugin ./meu-plugin
+mcp-gen watch -i ./api/openapi.yaml --plugin ./meu-plugin
+```
+
+Os templates do plugin substituem os do core quando usam o mesmo caminho em `templates/<lang>/`.
+
+---
+
+## Estrutura do projeto gerado
+
+**TypeScript:**
+```
+my-server/
+├── src/
+│   ├── server.ts        # MCP server — definições de tools + handlers
+│   └── models.ts        # Interfaces TypeScript geradas a partir dos schemas OpenAPI
+├── .github/
+│   └── workflows/
+│       └── ci.yml
+├── Dockerfile
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+**Python:**
+```
+my-server/
+├── server.py            # Servidor FastMCP — definições de tools + handlers
+├── models.py            # Modelos Pydantic gerados a partir dos schemas OpenAPI
+├── requirements.txt
+├── .github/
+│   └── workflows/
+│       └── ci.yml
+├── Dockerfile
+└── README.md
+```
+
+---
+
+## Conectar ao Claude Desktop
+
+**TypeScript:**
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "command": "node",
+      "args": ["/absolute/path/to/my-server/dist/server.js"]
+    }
+  }
+}
+```
+
+**Python:**
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "command": "python",
+      "args": ["/absolute/path/to/my-server/server.py"]
+    }
+  }
+}
+```
+
+Reinicie o Claude Desktop. As tools da sua API vão aparecer automaticamente.
+
+---
+
+## Implementar handlers
+
+Os arquivos gerados retornam exemplos da spec por padrão. Substitua os stubs pela lógica real.
+
+**TypeScript** (`src/server.ts`):
+```typescript
+case "get_users_id": {
+  // @@mcp-gen:start:get_users_id
+  const user = await db.users.findById(args.id);
+  return { content: [{ type: "text", text: JSON.stringify(user) }] };
+  // @@mcp-gen:end:get_users_id
+}
+```
+
+**Python** (`server.py`):
+```python
+@mcp.tool()
+async def get_users_id(id: float) -> Any:
+    # @@mcp-gen:start:get_users_id
+    user = await db.users.find_by_id(id)
+    return user
+    # @@mcp-gen:end:get_users_id
+```
+
+Código entre os marcadores `@@mcp-gen:start` e `@@mcp-gen:end` é preservado quando você roda `generate --incremental` novamente.
+
+---
+
+## Desenvolvimento
+
+```bash
+npm test
+npx tsc --noEmit
+
+# Exemplo TypeScript
+node dist/cli/index.js generate --input examples/petstore.json --out /tmp/ts-test --force
+
+# Exemplo Python
+node dist/cli/index.js generate --input examples/petstore.yaml --lang python --out /tmp/py-test --force
+
+# Exemplo incremental
+node dist/cli/index.js generate --input examples/petstore.json --out /tmp/ts-test --incremental
+```
+
+---
+
+## Roadmap
+
+| Etapa | Status | Escopo |
+|-------|--------|-------|
+| Recursos existentes | Implementados | CLI, parser OpenAPI v3, geração TypeScript/Python, geração incremental, modo interativo, registry de specs, plugins |
+| v2.1.0 | Com tag | Target Go, modo HTTP, enums, parâmetros header/cookie, API de biblioteca, validação detalhada |
+| v2.1.1 | Com tag | Análise estática de segurança/lint e verificações no template de servidor Go; templates TypeScript/Python sem alterações desde v2.1.0 |
+| v2.1.2 | Preparada para release | Cópia portátil de templates, lockfile, allowlist do pacote, build no prepack, workflow de release corrigido, smoke test do tarball na CI, atualização de dependências |
+| Distribuição | Não verificada | A publicação da 2.1.2 no npm precisa ser confirmada antes da instalação pelo registry; publicação via pip não comprovada. Python é um target de geração, não uma forma de instalar esta CLI via pip |
+| Futuro | Planejado | Streaming/resources/prompts, OpenAPI v2, mais registries |
+
+---
+
+## Limitações conhecidas
+
+- OpenAPI v2 (Swagger) não é suportado — apenas v3.x
+- `oneOf` / `anyOf` / `discriminator` são parcialmente tratados
+- A análise de segurança/lint usa padrões estáticos de texto e pode gerar falsos positivos ou deixar problemas passar. Um relatório aprovado não garante segurança nem verifica autorização, revogação, gastos ou auditoria em execução
+- As verificações de autorização geradas são scaffolding, não um backend completo de segurança; revise e teste antes do deploy
+- Streaming/resources/prompts ainda não estão implementados
+
+A correção de `copy-templates` incluída na 2.1.2 usa `fs.cpSync` do Node.js no Windows, Linux e macOS; não depende mais de `cp` ou `xcopy`. A CI atual executa apenas no Ubuntu.
+
+---
+
+## Licença
+
+MIT © 2026 - Christopher D.

package/RELEASE_NOTES.md

@@ -0,0 +1,98 @@
+# Notas de release
+
+## Estado e fontes
+
+A versão `2.1.2` do pacote `@christopher_dondici/mcp-gen` está preparada para release e ainda não foi publicada, com `package.json` e `package-lock.json` alinhados. O npm recusou `mcp-gen` por similaridade com `mcpgen`; a renomeação mantém a versão, o binário `mcp-gen` e o repositório. A publicação no npm não foi verificada; estas notas não confirmam publicação nem criação de tag. Uma tag Git ou um workflow de publicação não comprova disponibilidade no registry.
+
+A 2.1.2 reúne correções de build, empacotamento, CI e dependências, sem novas funcionalidades de runtime. Estas notas preservam o histórico da 2.1.1, confrontando o [CHANGELOG](CHANGELOG.md) com os diffs `v2.1.0..v2.1.1` e `v2.1.1..1629696`, e descrevem separadamente a preparação da 2.1.2. As seções históricas do changelog não foram alteradas; suas afirmações sobre publicação e segurança não confirmam o estado atual.
+
+## Funcionalidade histórica da v2.1.1
+
+Comparação: `v2.1.0..v2.1.1`.
+
+- Inclusão de `src/core/security-lint.ts`, com análise estática de padrões semelhantes a credenciais, referências a `authContext`, identificadores de políticas, nomes, descrições, TODO/FIXME e marcadores incrementais. Também há verificações de descrições e exemplos de uma spec encontrada no projeto; isso não equivale a validar integralmente seus schemas.
+- Novo comando `security` (alias `sec`) e opção no menu interativo. A sintaxe real exige `-p` ou `--project`, não o caminho posicional mostrado no changelog.
+- `--json` imprime o relatório em JSON; a CLI ainda imprime um cabeçalho antes dele, portanto stdout não é JSON puro. Erros encerram com código 1; `--fail-on-warn` também encerra com código 1 quando há avisos.
+- Exports de biblioteca: `scanProject`, `formatReport` e os tipos `SecurityRule` e `SecurityReport`.
+- Inclusão de 11 testes em `tests/security-lint.test.ts` e configuração explícita de transformação via `ts-jest`.
+- Ajustes nos textos e prompts da CLI, com remoção de textos bilíngues em diversos pontos.
+- O workflow de release passou a tentar condicionar `npm publish` à presença de `NPM_TOKEN`; a correção atual dessa condição é descrita separadamente abaixo.
+
+Exemplo após compilar o checkout local:
+
+```bash
+node dist/cli/index.js security -p ./my-server
+node dist/cli/index.js security -p ./my-server --fail-on-warn
+```
+
+### Templates: correção em relação ao changelog
+
+**Os templates TypeScript e Python não mudaram entre `v2.1.0` e `v2.1.1`.** As melhorias atribuídas a eles na seção 2.1.1 do changelog não aparecem nesse diff e não são novidades dessa tag.
+
+O template alterado foi `src/templates/go/server.go.hbs`: recebeu `RAW_CREDENTIAL_KEYS`, `TOOL_POLICIES`, `hasRawCredentialKey`, `requireSecurity` e a chamada de verificação nos handlers. Esses elementos são scaffolding e não comprovam uma implementação completa de autorização, auditoria ou revogação.
+
+Go, modo HTTP, enums, parâmetros header/cookie, API de biblioteca e validação detalhada já pertenciam à v2.1.0; não são novidades da v2.1.1.
+
+## Alterações após a tag até 1629696
+
+Comparação: `v2.1.1..1629696`.
+
+- `690de37`: remoção de comentários em `src/cli/index.ts`, `src/core/generator.ts` e `src/core/incremental.ts`, sem mudança de lógica executável nesse diff.
+- `1629696`: alteração da sintaxe do `if` referente a `NPM_TOKEN` no workflow de release. Ainda era uma referência direta a `secrets` na condição; a correção incluída na 2.1.2 abaixo substitui essa abordagem.
+- Nenhum template mudou nesse intervalo. Esses commits posteriores à tag não constituem uma nova versão publicada.
+
+## Correções incluídas na 2.1.2
+
+As alterações abaixo fazem parte da preparação da 2.1.2 e abrangem build, empacotamento, automação e dependências. Não adicionam funcionalidades aos servidores gerados e não fazem parte do conteúdo histórico da tag `v2.1.1`.
+
+### Build e pacote
+
+- `publishConfig.access` é `public` para o pacote scoped. O tarball da 2.1.2 se chama `christopher_dondici-mcp-gen-2.1.2.tgz` e a instalação local usa `node_modules/@christopher_dondici/mcp-gen`.
+- Para o pacote final, use um clone ou worktree limpo fora do checkout de desenvolvimento; `prepack` não remove arquivos antigos nem caches já existentes em `dist/`.
+- `copy-templates` usa uma chamada inline de Node.js a `fs.cpSync`, com cópia recursiva de `src/templates` para `dist/templates`. Não depende mais de `xcopy` nem de comandos de cópia específicos do shell.
+- A allowlist `files` inclui `dist/`, `examples/`, `README.md`, `README.pt-BR.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`, `SECURITY.md`, `SECURITY.pt-BR.md` e `LICENSE`. O npm também inclui seu manifesto automaticamente.
+- `prepack` executa `npm run build`, preparando o código compilado e os templates antes do empacotamento.
+- `package-lock.json` deixa de ser ignorado e passa a ser versionado com metadados alinhados a `2.1.2`, permitindo o fluxo `npm ci` com dependências fixadas pelo lockfile.
+- `repository.url` usa o formato normalizado `git+https://github.com/ChristopherDond/MCP-Generator.git`.
+- `npm run release` agora executa somente build e testes, removendo a chamada ao inexistente `scripts/release.js`. Esse comando não aumenta versão nem faz push.
+- **Os comandos explícitos `release:patch` e `release:rc` continuam presentes e podem aumentar a versão e fazer push de commits/tags.** `scripts/release.sh` e `scripts/release.bat` também permanecem, com operações de atualização de versão, push e criação de release no GitHub. Não são comandos de verificação local e não foram executados nesta tarefa.
+
+### CI e release
+
+- A nova CI é acionada por pushes em qualquer branch e por pull requests, em `ubuntu-latest` com Node.js 20.
+- Executa `npm ci`, `npx tsc --noEmit`, testes, build e `npm pack` real. Instala o tarball em um diretório temporário e verifica `--version` e `validate` usando o exemplo Petstore incluído no pacote.
+- O smoke test verifica instalação e execução básica do tarball; não compila nem executa servidores gerados em todas as linguagens. A CI não publica no npm e não testa Windows/macOS.
+- O workflow separado de release mantém o mesmo gatilho de tags estáveis (`v[0-9]+.[0-9]+.[0-9]+`). Verifica nome scoped, acesso público e correspondência entre tag e versão; executa typecheck, testes, build, pack e smoke test antes da publicação.
+- A publicação usa `--access public` sobre o mesmo tarball validado, também anexado à release GitHub. A lógica de RC inalcançável foi removida. Uma release GitHub sem publicação npm continua possível quando o segredo não está disponível; não comprova publicação no registry.
+- A variável de ambiente booleana `HAS_NPM_TOKEN` representa apenas a presença do segredo. O passo de publicação usa `if: env.HAS_NPM_TOKEN == 'true'`, em vez de consultar `secrets` diretamente no `if`. Isso não confirma que o pacote já foi publicado.
+
+### Dependências
+
+- Atualizações fixadas no lockfile da 2.1.2: `fast-uri` 3.1.8, `hono` 4.13.8, `js-yaml` 4.3.2 e `qs` 6.16.0. Resultados de auditoria dependem da data da consulta; essas versões não são uma garantia de ausência de vulnerabilidades.
+
+## Uso local
+
+Com Git, Node.js 20+ e npm 9+ instalados:
+
+```bash
+git clone https://github.com/ChristopherDond/MCP-Generator.git
+cd MCP-Generator
+npm ci
+npm run build
+node dist/cli/index.js --version
+node dist/cli/index.js generate -i examples/petstore.yaml -l typescript -o ./my-server
+node dist/cli/index.js validate -i examples/petstore.yaml
+```
+
+O fluxo acima usa a branch `main`, com as correções de build e empacotamento incluídas na 2.1.2, não um checkout isolado da tag histórica `v2.1.1`. A geração cria arquivos; não instala dependências nem inicia o servidor gerado.
+
+Quando a versão 2.1.2 for publicada e sua disponibilidade no npm for confirmada, a instalação pelo registry poderá ser feita com `npm install -g @christopher_dondici/mcp-gen@2.1.2`. Até essa confirmação, use o fluxo pelo código-fonte.
+
+Nos READMEs, `mcp-gen` é uma abreviação de `node dist/cli/index.js` na raiz do repositório. Opcionalmente, `npm link` após o build cria o comando apontando para o checkout local, alterando os links globais do npm sem depender de uma publicação de `@christopher_dondici/mcp-gen` no registry. Não há fluxo de instalação desta CLI via pip confirmado.
+
+## Limitações
+
+- A análise de segurança é estática, baseada em padrões de texto: pode gerar falsos positivos e deixar problemas passar. Um relatório aprovado não garante segurança nem prontidão para produção.
+- Encontrar nomes de políticas ou funções no texto não comprova sua execução nem valida autorização, TTL, limites financeiros, revogação ou persistência de auditoria. Esses controles precisam de revisão e integração com um backend confiável.
+- Os servidores gerados são scaffolds e exigem testes e revisão antes do deploy; não há garantia de segurança ou de equivalência entre os targets.
+- OpenAPI v2 não é suportado. Unions geradas de `oneOf`/`anyOf`/`discriminator` não fornecem validação completa em runtime. Streaming/resources/prompts ainda não estão implementados.

package/SECURITY.md

@@ -0,0 +1,75 @@
+# Security Policy
+
+## Overview
+
+This document outlines the security measures and practices implemented in the MCP Generator project.
+
+## Security Features
+
+### 1. Path Traversal Protection
+- All output file paths are validated to prevent directory traversal attacks
+- Uses `validateOutputPath()` to ensure files are written only to the intended output directory
+- Rejects paths that attempt to access parent directories
+
+### 2. Plugin Security
+- By default, dynamic plugin code loading is **disabled**
+- Plugins can only provide templates, not arbitrary code execution
+- To enable plugin code loading (not recommended for untrusted sources):
+  ```bash
+  MCP_GEN_ALLOW_PLUGINS=true mcp-gen generate --plugin ./my-plugin ...
+  ```
+- Plugin modules are validated for safe exports
+- Symbolic links are rejected to prevent symlink attacks
+
+### 3. Remote URL Validation
+- Only HTTPS URLs are allowed for fetching OpenAPI specs
+- Private/local IP addresses and localhost are blocked (SSRF prevention)
+- Content-Type validation (only JSON/YAML allowed)
+- Content-Length validation (max 50MB)
+- 30-second timeout on remote fetches
+
+### 4. Input Sanitization
+- User inputs are sanitized to remove null bytes and control characters
+- Length limits enforced on user-provided strings
+
+## Vulnerability Fixes
+
+### Fixed Issues
+- ✅ Remote Code Execution via plugin loading - **MITIGATED**: Dynamic code loading disabled by default
+- ✅ Path traversal - **FIXED**: All output paths validated
+- ✅ SSRF attacks - **FIXED**: URL validation and IP filtering
+- ✅ Dependency vulnerabilities - **FIXED**: All packages audited and updated
+
+## Best Practices
+
+### For Users
+1. Keep the project updated: `npm audit fix`
+2. Do not enable `MCP_GEN_ALLOW_PLUGINS` with untrusted sources
+3. Validate OpenAPI specs from unknown sources before generation
+4. Use `--force` carefully when overwriting existing projects
+
+### For Developers
+1. Run `npm audit` before committing
+2. Add security tests for new features
+3. Never suppress security warnings
+4. Review security.ts for validation functions before adding new file operations
+
+## Security Audit Checklist
+
+- [x] Path traversal protection
+- [x] Plugin execution control
+- [x] Remote URL validation
+- [x] Dependency vulnerability scanning
+- [x] Input sanitization
+- [ ] Code signing (future)
+- [ ] Security headers (future)
+
+## Reporting Security Issues
+
+If you discover a security vulnerability, please email security@example.com instead of using the issue tracker.
+
+## References
+
+- [OWASP Path Traversal](https://owasp.org/www-community/attacks/Path_Traversal)
+- [OWASP SSRF](https://owasp.org/www-community/attacks/Server-Side_Request_Forgery)
+- [OWASP Code Injection](https://owasp.org/www-community/attacks/Code_Injection)

package/SECURITY.pt-BR.md

@@ -0,0 +1,77 @@
+# Política de Segurança
+
+## Visão Geral
+
+Este documento descreve as medidas e práticas de segurança implementadas no projeto MCP Generator.
+
+## Recursos de Segurança
+
+### 1. Proteção contra Path Traversal
+- Todos os caminhos de arquivo de saída são validados para prevenir ataques de travessia de diretório
+- Usa `validateOutputPath()` para garantir que os arquivos sejam gravados apenas no diretório de saída pretendido
+- Rejeita caminhos que tentam acessar diretórios pai
+
+### 2. Segurança de Plugins
+- Por padrão, o carregamento dinâmico de código de plugin está **desabilitado**
+- Os plugins podem fornecer apenas templates, não execução arbitrária de código
+- Para ativar o carregamento de código de plugin (não recomendado para fontes não confiáveis):
+  ```bash
+  MCP_GEN_ALLOW_PLUGINS=true mcp-gen generate --plugin ./meu-plugin ...
+  ```
+- Módulos de plugin são validados para exportações seguras
+- Links simbólicos são rejeitados para prevenir ataques de symlink
+
+### 3. Validação de URL Remota
+- Apenas URLs HTTPS são permitidas para buscar specs OpenAPI
+- Endereços IP privados e localhost são bloqueados (prevenção de SSRF)
+- Validação de Content-Type (apenas JSON/YAML permitidos)
+- Validação de Content-Length (máximo 50MB)
+- Timeout de 30 segundos em buscas remotas
+
+### 4. Sanitização de Entrada
+- Entradas do usuário são sanitizadas para remover bytes nulos e caracteres de controle
+- Limites de comprimento aplicados em strings fornecidas pelo usuário
+
+## Correções de Vulnerabilidades
+
+### Problemas Corrigidos
+- ✅ Execução Remota de Código via carregamento de plugin - **MITIGADO**: Carregamento dinâmico desabilitado por padrão
+- ✅ Path traversal - **CORRIGIDO**: Todos os caminhos de saída validados
+- ✅ Ataques SSRF - **CORRIGIDO**: Validação de URL e filtragem de IP
+- ✅ Vulnerabilidades de dependência - **CORRIGIDO**: Todos os pacotes auditados e atualizados
+
+## Melhores Práticas
+
+### Para Usuários
+1. Mantenha o projeto atualizado: `npm audit fix`
+2. Não ative `MCP_GEN_ALLOW_PLUGINS` com fontes não confiáveis
+3. Valide specs OpenAPI de fontes desconhecidas antes de gerar
+4. Use `--force` com cuidado ao sobrescrever projetos existentes
+
+### Para Desenvolvedores
+1. Execute `npm audit` antes de fazer commit
+2. Adicione testes de segurança para novas funcionalidades
+3. Nunca suprima avisos de segurança
+4. Revise security.ts para funções de validação antes de adicionar novas operações de arquivo
+
+## Lista de Verificação de Auditoria de Segurança
+
+- [x] Proteção contra path traversal
+- [x] Controle de execução de plugins
+- [x] Validação de URL remota
+- [x] Verificação de vulnerabilidades de dependência
+- [x] Sanitização de entrada
+- [ ] Assinatura de código (futuro)
+- [ ] Headers de segurança (futuro)
+
+## Reportando Problemas de Segurança
+
+Se você descobrir uma vulnerabilidade de segurança, por favor envie um email para security@example.com em vez de usar o rastreador de problemas.
+
+## Referências
+
+- [OWASP Path Traversal](https://owasp.org/www-community/attacks/Path_Traversal)
+- [OWASP SSRF](https://owasp.org/www-community/attacks/Server-Side_Request_Forgery)
+- [OWASP Injeção de Código](https://owasp.org/www-community/attacks/Code_Injection)
+- [CWE-22: Improper Limitation of a Pathname to a Restricted Directory](https://cwe.mitre.org/data/definitions/22.html)
+- [CWE-918: Server-Side Request Forgery (SSRF)](https://cwe.mitre.org/data/definitions/918.html)

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}