How do I use MCP Sankhya Community Search Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Sankhya Community Search Server pesquise por erro de validação de nota fiscal na comunidade" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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}`