MediaWiki MCP Server

MediaWiki MCP Server

Um servidor MCP (Model Context Protocol) que permite que clientes de Modelos de Linguagem de Grande Porte (LLMs) interajam com qualquer wiki MediaWiki.

Recursos

Ferramentas

Toda 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 na qual a chamada foi executada. Cada resposta bem-sucedida carrega seu conteúdo como prosa em content e como JSON em structuredContent; veja canais de resposta.

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 em 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 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 nome de host interno (ex.: http://mediawiki em Docker); URLs devolvidas ao chamador são construídas a partir do endereço público da wiki, portanto nomes de host internos não vazam em 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) são recusadas em uma wiki que tenha readOnly: true, e ocultadas de tools/list quando toda wiki configurada a tiver — veja Implantação.

• OAuth baseado em navegador (recomendado). Entre por meio de 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 de portador por solicitação (HTTP), obsoleto. Cada solicitação carrega Authorization: Bearer <token> e o servidor o encaminha ao 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 de portador por solicitação.
• Proxy OAuth hospedado (HTTP). O servidor atua como um Servidor de Autorização OAuth 2.1 para um consumidor do MediaWiki, de modo que um cliente ciente de OAuth autentica cada usuário — sem tokens manuais. Aponte-o para https://<wiki>/mcp; 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 restringem exigem a permissão Create, query and delete data through the Cargo extension na senha do 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 a autenticação para gravações, consulte docs/configuration.md.

Claude Code

Adicione este repositório como um marketplace de plugins e 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 sua própria wiki. Defina-o pelo prompt ao ativar 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 ou hooks de ferramentas de acordo.

Para configurar o servidor diretamente, consulte a documentação 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 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 sua própria wiki, defina CONFIG no shell de onde 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 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 à 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 isso 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 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 é um 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 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 — consulte 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), consulte 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. Consulte docs/deployment.md — checklist de segurança.
• Combine 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 abre com MCP_BIND=0.0.0.0, defina MCP_ALLOWED_HOSTS para os hostnames 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 fica desabilitado até você listar diretórios permitidos em uploadDirs ou MCP_UPLOAD_DIRS. Consulte 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 resolve para um endereço privado ou loopback (por exemplo, um alias de rede Docker como mediawiki.svc) é recusado até você listar seu host em MCP_TRUSTED_HOSTS. Consulte docs/deployment.md — proteção SSRF de saída.

Reporte uma vulnerabilidade pelo formulário de advisory 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 ambos.

• 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? Consulte docs/releasing.md.

Licença

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