MediaWiki MCP Server

MediaWiki MCP Server

Um servidor MCP (Model Context Protocol) que permite que clientes de Large Language Model (LLM) interajam com qualquer wiki MediaWiki.

Recursos

Ferramentas

Cada ferramenta que opera em uma wiki aceita um argumento opcional wiki nomeando a wiki na qual atuar (as ferramentas de gerenciamento de wiki e OAuth não aceitam) — passe uma chave de wiki (ex.: en.wikipedia.org) ou a URI mcp://wikis/{wikiKey} completa. Omita-o para usar a wiki padrão configurada (veja Configuração). Cada resposta de ferramenta informa a wiki em que a chamada foi executada.

Leituras de página

Escritas de página

Gerenciamento de wiki

OAuth

Pacotes de extensão

As ferramentas de cada pacote são registradas apenas em wikis onde sua extensão está instalada.

NeoWiki

Semantic MediaWiki

Bucket

Cargo

Wikibase

Recursos

mcp://wikis/{wikiKey} — recurso por wiki que expõe sitename, server (o endereço público da wiki), articlepath, scriptpath e as flags private e readOnly.

• Esses campos são tudo o que ele contém: o recurso publica uma lista fixa, portanto credenciais e configurações do lado do servidor no seu arquivo de configuração nunca são expostas no conteúdo do recurso.
• Após add-wiki ou remove-wiki, o servidor envia notifications/resources/list_changed para que os clientes atualizem.

{
  "contents": [
    {
      "uri": "mcp://wikis/en.wikipedia.org",
      "mimeType": "application/json",
      "text": "{ \"sitename\":\"Wikipedia\",\"server\":\"https://en.wikipedia.org\",\"articlepath\":\"/wiki\",\"scriptpath\":\"/w\",\"private\":false }"
    }
  ]
}

Variáveis de ambiente

As variáveis abaixo são relevantes para qualquer configuração. Variáveis que se aplicam apenas ao auto-hospedar o transporte HTTP (portas, timeouts, proteções de Host/Origin e SSRF) ou ao executar o proxy OAuth hospedado estão em docs/deployment.md — variáveis de ambiente. Variáveis de substituição de arquivo de configuração e diretório de upload estão em docs/configuration.md.

Configuração

[!NOTE] A configuração só é necessária ao interagir com uma wiki privada ou ao usar ferramentas autenticadas.

Crie um arquivo config.json para configurar conexões de wiki. Use o config.example.json como ponto de partida.

{
  "defaultWiki": "en.wikipedia.org",
  "wikis": {
    "en.wikipedia.org": {
      "sitename": "Wikipedia",
      "server": "https://en.wikipedia.org",
      "articlepath": "/wiki",
      "scriptpath": "/w"
    }
  }
}

Endereço interno vs. público. O server que você configura pode ser um hostname interno (ex.: http://mediawiki no Docker); URLs devolvidas ao chamador são construídas a partir do endereço público da wiki, portanto hostnames internos não vazam para os links. Veja docs/configuration.md — campos por wiki.

Para a referência completa de campos, substituição de variáveis de ambiente, fontes de segredos, tags de mudança, diretórios de upload e opções de autenticação, veja docs/configuration.md.

Autenticação

Ferramentas marcadas com 🔐 exigem autenticação. Ferramentas de escrita (incluindo escritas de pacotes de extensão) ficam ocultas de tools/list quando a wiki padrão configurada tem readOnly: true — veja Implantação.

• OAuth baseado em navegador (recomendado). Faça login em uma aba do navegador na primeira vez que uma ferramenta precisar de autenticação. Defina oauth2ClientId e oauth2CallbackPort por wiki — veja docs/configuration.md — OAuth (baseado em navegador).
• Token bearer por requisição (HTTP), obsoleto. Cada requisição carrega Authorization: Bearer <token> e o servidor o encaminha para o MediaWiki. Desativado por padrão, porque um servidor MCP não deve aceitar tokens que não foram emitidos para ele. Veja docs/deployment.md — token bearer por requisição.
• Proxy OAuth hospedado (HTTP). O servidor atua como um Authorization Server OAuth 2.1 para um consumidor MediaWiki, de modo que um cliente com suporte a OAuth autentica cada usuário — sem tokens manuais. Aponte-o para https://<wiki>/mcp; a leitura anônima ainda funciona. Veja docs/deployment.md — login OAuth hospedado.
• Token de acesso OAuth2 manual. Cole um token de longa duração em config.json. Veja docs/configuration.md — token de acesso OAuth2 manual.
• Senha de bot. Alternativa quando a Extension:OAuth não está instalada. Veja docs/configuration.md — senha de bot.

As ferramentas Cargo (cargo-query, cargo-list-tables, cargo-describe-table) chamam ações da API controladas pelo direito de usuário runcargoqueries. A maioria das wikis concede isso a todos os usuários por padrão; wikis que o restringem exigem a concessão Create, query and delete data through the Cargo extension na senha de bot ou no consumidor OAuth. A extensão Cargo também é detectada em wikis hospedadas na wiki.gg (Helldivers, Terraria, Ark, etc.), onde é distribuída sob o nome renomeado LIBRARIAN.

Instalação

Escolha seu cliente abaixo ou use a configuração padrão se ele não estiver listado. CONFIG é opcional; sem ele, o servidor tem como alvo a Wikipédia em inglês. Para apontá-lo para sua própria wiki e configurar autenticação para escritas, veja docs/configuration.md.

Claude Code

Adicione este repositório como um marketplace de plugins e, em seguida, instale o servidor incluído:

/plugin marketplace add ProfessionalWiki/MediaWiki-MCP-Server
/plugin install mediawiki-mcp-server@professional-wiki

O plugin aceita um arquivo de configuração opcional, que aponta o servidor para a sua própria wiki. Defina-o pelo prompt ao habilitar o plugin, ou a qualquer momento com /plugin configure mediawiki-mcp-server@professional-wiki. Uma instalação por linha de comando aceita o mesmo valor via claude plugin install mediawiki-mcp-server@professional-wiki --config configPath=path/to/config.json.

Quando instalado como plugin, as ferramentas são namespaced como mcp__plugin_mediawiki-mcp-server_mediawiki__<tool>; atualize quaisquer allowlists de ferramentas ou hooks de acordo.

Para configurar o servidor diretamente, veja a documentação do MCP do Claude Code. A versão resumida:

claude mcp add mediawiki-mcp-server -- npx -y @professional-wiki/mediawiki-mcp-server@latest
# Environment variables go before the `--`:
claude mcp add mediawiki-mcp-server -e CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest

Codex

Adicione este repositório como um marketplace de plugins e, em seguida, instale o servidor incluído:

codex plugin marketplace add ProfessionalWiki/MediaWiki-MCP-Server
codex plugin add mediawiki-mcp-server@professional-wiki

Para apontar o plugin para a sua própria wiki, defina CONFIG no shell a partir do qual você inicia o Codex, por exemplo export CONFIG=path/to/config.json. O Codex não tem configuração por plugin; se você preferir não definir uma variável de ambiente, codex mcp add mediawiki --env CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest registra o servidor diretamente e tem precedência sobre a cópia do plugin.

Consulte a documentação de plugins do Codex para saber como listar, atualizar ou remover plugins.

Claude Desktop

Baixe MediaWiki-MCP-Server.mcpb e clique duas vezes para instalar a extensão, que solicita um caminho de arquivo de configuração para que você possa apontá-la para a sua própria wiki em vez da Wikipédia em inglês.

VS Code e Cursor

Ou adicione a configuração padrão manualmente.

Antigravity

Adicione a configuração padrão ao arquivo de configuração MCP do Antigravity, seja globalmente em ~/.gemini/config/mcp_config.json ou por workspace em .agents/mcp_config.json.

Se você instalou anteriormente a extensão Gemini CLI, o assistente de configuração do Antigravity oferece importar sua configuração existente do Gemini CLI.

OpenCode

O OpenCode usa seu próprio formato de configuração em vez de mcpServers; adicione isto a opencode.json na raiz do seu projeto, ou ~/.config/opencode/opencode.json para uma instalação global.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mediawiki-mcp-server": {
      "type": "local",
      "command": ["npx", "-y", "@professional-wiki/mediawiki-mcp-server@latest"],
      "environment": {
        "CONFIG": "path/to/config.json"
      }
    }
  }
}

Configuração padrão

A maioria dos clientes lê o mesmo bloco de servidor. Cole-o no arquivo listado para o seu cliente, substituindo mcpServers pela chave raiz desse cliente:

{
  "mcpServers": {
    "mediawiki-mcp-server": {
      "command": "npx",
      "args": ["-y", "@professional-wiki/mediawiki-mcp-server@latest"],
      "env": {
        "CONFIG": "path/to/config.json"
      }
    }
  }
}

Para qualquer outro cliente, npx add-mcp @professional-wiki/mediawiki-mcp-server pode funcionar: add-mcp é uma CLI da comunidade que escreve o arquivo de configuração do seu cliente para você. Ele define apenas o comando de inicialização; adicione CONFIG você mesmo para apontar para a sua própria wiki.

Implantação

Executar o servidor como um endpoint HTTP remoto para outros usuários tem seus próprios requisitos de configuração — veja docs/deployment.md. Uma imagem pré-construída é publicada em ghcr.io/professionalwiki/mediawiki-mcp-server. Para operações de dia 2 (logs, /health//ready, métricas, desligamento gracioso), veja docs/operations.md.

Segurança

Os padrões são seguros para uso de usuário único. Antes de expor o transporte HTTP a outros, restrinja três coisas:

• Encerre o TLS no seu proxy reverso. Não exponha a porta MCP diretamente em uma rede não confiável. Veja docs/deployment.md — lista de verificação de segurança.
• Emparelhe MCP_BIND com MCP_ALLOWED_HOSTS e MCP_ALLOWED_ORIGINS. O transporte HTTP vincula-se a 127.0.0.1 por padrão. Quando você o abrir com MCP_BIND=0.0.0.0, defina MCP_ALLOWED_HOSTS para os nomes de host que seu proxy encaminha e MCP_ALLOWED_ORIGINS para as origens de navegador permitidas a chamar o servidor — eles bloqueiam ataques de rebinding de DNS e de origem cruzada, respectivamente.
• Uploads são opcionais. upload-file está desabilitado até que você liste diretórios permitidos em uploadDirs ou MCP_UPLOAD_DIRS. Veja docs/configuration.md — diretórios de upload.
• Destinos internos precisam de MCP_TRUSTED_HOSTS. Buscas de saída são protegidas contra SSRF: um destino que resolva para um endereço privado ou loopback (por exemplo, um alias de rede Docker como mediawiki.svc) é recusado até que você liste seu host em MCP_TRUSTED_HOSTS. Veja docs/deployment.md — proteção SSRF de saída.

Reporte uma vulnerabilidade pelo formulário de aviso de segurança do GitHub — política completa em SECURITY.md.

Contribuindo

Contribuições são bem-vindas — pull requests e issues (bugs, solicitações de recursos, sugestões) funcionam.

• Trabalhando no código das ferramentas? Comece por AGENTS.md para a estrutura do repositório, comandos e padrões de teste.
• Adicionando ou modificando uma ferramenta? Leia docs/tool-conventions.md — cobre voz de descrição, documentação de parâmetros, dicas de anotação e convenções de terminologia do MediaWiki.
• Fazendo um release? Veja docs/releasing.md.

Licença

Este projeto é licenciado sob a Licença MIT. Veja o arquivo LICENSE para detalhes.