MCP Sankhya Community Search Server
Servidor MCP (Model Context Protocol) em Python 3 que permite a modelos de IA pesquisar e ler tópicos na Comunidade Sankhya — discussões onde desenvolvedores resolvem problemas técnicos, personalizações e erros do sistema.
---
Estrutura do Projeto
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---
Pré-requisitos
- Python 3.10+
- Microsoft Edge instalado (para o Selenium headless na busca)
- Microsoft Edge WebDriver compatível com a versão do Edge instalada
---
Instalação
# 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---
Executar o Servidor MCP
# Modo padrão (stdio — integração com Claude Desktop)
python mcp_server.py
# Modo rede (HTTP/SSE)
fastmcp run mcp_server.py --transport sse---
Testar Módulos Individualmente
Cada módulo pode ser executado diretamente para validação manual:
# 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"---
Executar os Testes
pytest tests/ -v---
Ferramentas MCP Disponíveis
| Ferramenta | Descrição | |---|---| | pesquisar_comunidade | Pesquisa tópicos/discussões por termo. Retorna título, URL e resumo dos resultados. | | acessar_postagem_comunidade | Acessa um post específico e retorna o conteúdo limpo (sem menus/rodapés). Restrito a community.sankhya.com.br. | | obter_respostas | Busca respostas/replies de um post por ID, com paginação (limit e after). |
---
Configuração no Claude Desktop
Adicione ao seu claude_desktop_config.json:
{
"mcpServers": {
"sankhya-community": {
"command": "python",
"args": ["C:/caminho/para/mcp-sankhya/mcp_server.py"]
}
}
}---
Rotas da Comunidade Sankhya
| Destino | URL | |---|---| | Home | https://community.sankhya.com.br/ | | Pesquisa | https://community.sankhya.com.br/search?query={TERMO}&type=posts&expanded=posts | | Post | https://community.sankhya.com.br/wms/post/{SLUG} |
