MediaWiki MCP Server

MediaWiki MCP Server

Conecte seu assistente de IA a qualquer wiki MediaWiki, ou automatize-o diretamente do terminal. Pesquise, leia e edite conteúdo do wiki usando linguagem natural ou a CLI wiki.

Três formas de usar:

1. Servidor MCP — Claude Desktop, Claude Code, Cursor, ChatGPT, n8n, VS Code, Google ADK, ou qualquer ferramenta compatível com MCP. Veja SETUP.md.
2. CLI wiki — mesmo cliente de API, mesma autenticação, sem necessidade de IA. Para pipelines de shell, verificações de CI, tarefas agendadas. Veja CLI.md.
3. Plugin Claude Code — /plugin marketplace add olgasafonova/mediawiki-mcp-server adiciona habilidades de wiki diretamente ao Claude Code. Veja .claude-plugin/README.md.

---

Documentação

Documento	O que cobre
QUICKSTART.md	Comece a usar em 2 minutos
SETUP.md	Configuração por ferramenta (Claude Desktop, Cursor, ChatGPT, n8n, VS Code, Google ADK)
CLI.md	Referência da linha de comando wiki
TOOLS.md	Referência completa de ferramentas (43 ferramentas por categoria)
DEPLOYMENT.md	Transporte HTTP, segurança, endpoints, variáveis de ambiente
TIETO_SETUP.md	Conecte-se ao Public 360° Wiki da Tieto (amigável para iniciantes)
WIKI_USE_CASES.md	Fluxos de trabalho detalhados por perfil
ARCHITECTURE.md	Design do sistema
CONTRIBUTING.md	Como contribuir
SECURITY.md	Políticas de segurança
CHANGELOG.md	Histórico de versões

---

O Que Você Pode Fazer?

A mesma operação funciona a partir de um prompt (via MCP) ou diretamente no seu shell (via CLI wiki):

Objetivo	Prompt para sua IA	Do seu terminal
Pesquisar no wiki	"O que nosso wiki diz sobre integração?"	wiki search "onboarding"
Ler uma página	"Mostre-me a página Getting Started"	wiki page "Getting Started"
Encontrar links quebrados	"Existem links quebrados na página Docs?"	wiki links broken --json
Encontrar conteúdo desatualizado	"Quais páginas não foram atualizadas nos últimos 90 dias?"	wiki stale-pages --days 90
Sugestões de links cruzados	"Quais páginas são semelhantes à API Reference?"	wiki similar "API Reference"
Auditar saúde do wiki	"Execute uma verificação de saúde no wiki"	wiki audit --json
Publicar markdown	"Publique este README no wiki"	wiki publish README.md "Page Title"
Riscar um nome	"Risque John Smith na página Team"	wiki replace "Team" --find "John Smith" --replace "<s>John Smith</s>"

Para a lista completa de ferramentas, veja TOOLS.md. A CLI retorna códigos de saída tipados para ramificações compatíveis com CI — veja CLI.md.

---

Início em 30 Segundos

1. Obtenha o binário. Baixe de Releases ou go build -o mediawiki-mcp-server . (requer Go 1.24+).
2. Encontre a URL da API do seu wiki — geralmente https://your-wiki.com/api.php. A Wikipedia é https://en.wikipedia.org/w/api.php. Visite Special:Version para confirmar.
3. Conecte à sua ferramenta de IA — veja SETUP.md para a configuração que corresponde ao seu cliente.

Ler wikis públicos funciona sem login. Wikis privados/corporativos e edição exigem uma senha de bot — SETUP.md#editing-wiki-pages.

---

Exemplos de Prompts

📖 Mais exemplos: veja WIKI_USE_CASES.md para fluxos de trabalho detalhados por perfil (editores de conteúdo, gerentes de documentação, desenvolvedores).

Pesquisar e ler:

• "O que nosso wiki diz sobre implantação?"
• "Dê-me uma visão geral rápida da página Configuration"
• "Obtenha o conteúdo de Main Page, FAQ e Setup de uma só vez"

Acompanhar alterações:

• "Quais páginas foram atualizadas esta semana?"
• "Mostre-me a diferença entre as duas últimas versões"
• "Quem são os editores mais ativos este mês?"

Verificar qualidade:

• "Existem links quebrados nesta página?"
• "Encontre páginas órfãs sem links para elas"
• "Encontre páginas semelhantes ao Installation Guide"
• "Encontre páginas não atualizadas nos últimos 90 dias"

Gerenciamento de páginas (requer autenticação):

• "Renomeie 'Old Guide' para 'Updated Guide'"
• "Risque John Smith na página Team"
• "Substitua 'version 2.0' por 'version 3.0' em Release Notes"

Upload de arquivos e pesquisa (requer autenticação):

• "Envie esta imagem da URL para o wiki"
• "Envie este arquivo local para o wiki" (o agente codifica os bytes em base64; nenhuma URL pública é necessária)
• "Pesquise por 'budget' em File:Annual-Report.pdf"

Converter Markdown:

• "Converta este README para o formato do wiki"
• "Converta com a marca e CSS da Tieto" (use theme="tieto", add_css=true)

---

Configuração de Pesquisa em PDF

A pesquisa em PDF requer a ferramenta pdftotext do poppler-utils. A pesquisa em arquivos de texto (TXT, MD, CSV, etc.) funciona sem dependências.

Plataforma	Comando de Instalação
macOS	brew install poppler
Ubuntu/Debian	apt install poppler-utils
RHEL/CentOS	yum install poppler-utils
Windows	choco install poppler

Alternativa para Windows: Baixe os binários de poppler-windows releases e adicione ao PATH.

Verifique a instalação:

pdftotext -v

---

Compatibilidade

Plataforma	Transporte	Status
Claude Desktop (Mac/Windows)	stdio	✅ Suportado
Claude Code CLI	stdio	✅ Suportado
Cursor	stdio	✅ Suportado
VS Code	stdio	✅ Suportado
ChatGPT	HTTP	✅ Suportado
n8n	HTTP	✅ Suportado
Google ADK	stdio / HTTP	✅ Suportado

Funciona com qualquer wiki: Wikipedia, Fandom, wikis corporativos ou qualquer instalação MediaWiki.

---

Solução de Problemas

Problemas comuns e correções estão em SETUP.md#troubleshooting. Para diagnósticos mais aprofundados, o servidor HTTP expõe os endpoints /health, /ready e /status — veja DEPLOYMENT.md.

---

Desenvolvimento

Compile, teste e contribua: veja CONTRIBUTING.md. Para o design do sistema, estrutura de pacotes e fluxo de dados, veja ARCHITECTURE.md.

Execute a verificação completa antes de enviar:

go test -race -failfast ./...
golangci-lint run ./...

Os testes de integração são executados contra uma instância real do MediaWiki via docker-compose.test.yml. Veja CONTRIBUTING.md para o fluxo de trabalho.

---

Gostou Deste Projeto?

Se este servidor economizou seu tempo, considere dar uma ⭐ no GitHub. Isso ajuda outras pessoas a descobrirem o projeto.

Mais Servidores MCP

Confira meus outros servidores MCP:

Servidor	Descrição	Estrelas
gleif-mcp-server	Acesse o banco de dados GLEIF LEI. Consulte identidades de empresas, verifique entidades legais.
miro-mcp-server	Controle quadros brancos Miro com IA. Quadros, diagramas, mapas mentais e muito mais.
nordic-registry-mcp-server	Acesse registros empresariais nórdicos. Consulte empresas na Noruega, Dinamarca, Finlândia e Suécia.
productplan-mcp-server	Fale com seus roadmaps do ProductPlan. Consulte OKRs, ideias, lançamentos.
tilbudstrolden-mcp	Caça a ofertas de supermercado nórdicas. Encontre ofertas, planeje refeições, acompanhe gastos.
mcp-servercard-go	Biblioteca Go para SEP-2127 Server Cards. Descoberta pré-conexão para servidores MCP.

---

Licença

Licença MIT

Créditos

• Construído com Go MCP SDK
• Desenvolvido com MediaWiki API