MCP Sankhya社区搜索服务器
Python 3中的模型上下文协议(MCP)服务器,允许人工智能模型搜索和读取主题 Sankhya 社区 - 讨论开发人员解决技术问题,自定义和系统错误。
______________________________________________________________________
项目结构
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______________________________________________________________________
先决条件
- Python 3.10+
- 已安装 Microsoft Edge(用于搜索中的无头 Selenium)
- 与安装的 Edge 版本兼容的 Microsoft Edge WebDriver
______________________________________________________________________
安装
# 1. Clone o repositório
git clone
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______________________________________________________________________
运行 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______________________________________________________________________
单独测试模块
每个模块都可以直接运行进行手动验证:
# 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______________________________________________________________________
可用的 MCP 工具
| 工具 | 描述 |
|---|---|
pesquisar_comunidade 按术语搜索主题/讨论。返回标题、URL 和结果摘要。 | |
acessar_postagem_comunidade 访问特定的帖子,并返回干净的内容(没有菜单/页脚)。限制为 community.sankhya.com.br. | |
obter_respostas 按 ID 查找帖子的答案/回复,包括分页 (limit e after). |
______________________________________________________________________
Claude 桌面配置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"sankhya-community": {
"command": "python",
"args": ["C:/caminho/para/mcp-sankhya/mcp_server.py"]
}
}
}______________________________________________________________________
Sankhya 社区路线
| Destino | URL |
|---|---|
| 主页 | https://community.sankhya.com.br/ |
| 搜索 | https://community.sankhya.com.br/search?query={TERMO}&type=posts&expanded=posts |
| 职位 | https://community.sankhya.com.br/wms/post/{SLUG} |
