mcp-sankhya/
├── mcp_server.py           # Ponto de entrada: inicializa o servidor e registra as tools
├── requirements.txt        # Dependências do projeto (inclui pytest para testes)
├── .gitignore
│
├── src/                    # Módulos de negócio (testáveis isoladamente)
│   ├── __init__.py
│   ├── comunidade_sankhya.py   # Pesquisa de tópicos via Selenium + BeautifulSoup
│   └── leitor_paginas.py       # Leitura e limpeza de conteúdo de posts
│
├── tests/                  # Testes unitários
│   ├── __init__.py
│   ├── test_comunidade_sankhya.py
│   └── test_leitor_paginas.py
│
├── config/                 # Configurações de ambiente (ex.: .env, claude_desktop_config)
└── docs/                   # Documentação complementar

# 1. Clone o repositório
git clone <url-do-repositorio>
cd mcp-sankhya

# 2. Crie e ative o ambiente virtual
python -m venv .venv
.venv\Scripts\activate        # Windows
# source .venv/bin/activate   # Linux/macOS

# 3. Instale as dependências
pip install -r requirements.txt

# Modo padrão (stdio — integração com Claude Desktop)
python mcp_server.py

# Modo rede (HTTP/SSE)
fastmcp run mcp_server.py --transport sse

# Pesquisar tópicos na comunidade
python -m src.comunidade_sankhya "nota fiscal"

# Ler e limpar conteúdo de um post
python -m src.leitor_paginas "https://community.sankhya.com.br/wms/post/slug-do-post"

pytest tests/ -v

{
  "mcpServers": {
    "sankhya-community": {
      "command": "python",
      "args": ["C:/caminho/para/mcp-sankhya/mcp_server.py"]
    }
  }
}