Wikidata + Google Knowledge Graph MCP

Busca limitada no Wikidata e fatos selecionados, verificações cruzadas opcionais com o Google Knowledge Graph, e resolução determinística de entidades que retorna HOLD/AMBIGUOUS em vez de adivinhar. Servidor local stdio (PyPI: wikidata-google-knowledge-mcp) além de uma CLI para resolução em lote JSONL com evidências auditáveis. Submissão do mantenedor.

Documentação

Wikidata + Google Knowledge Graph MCP

Um servidor MCP e CLI de código aberto que permite que agentes de IA pesquisem no Wikidata, leiam fatos selecionados e vinculem seus próprios registros a QIDs do Wikidata, com evidências que você pode inspecionar e respostas explícitas quando as evidências não são suficientes.

Use-o como um servidor MCP do Wikidata no Claude Code, Cursor, Codex ou qualquer cliente MCP que inicie servidores stdio locais. O Wikidata não exige conta ou chave. A API de Pesquisa do Google Knowledge Graph é opcional.

Instale em dois minutos · Código-fonte no GitLab

O que você obtém

Pesquisa limitada

3 candidatos por padrão (5 no máximo) com sinalizadores de correspondência de nome, local e tipo, não 50 resultados brutos.

Fatos selecionados

Apenas as propriedades que você solicitar; classificações, qualificadores e referências sob demanda.

Resolução determinística

Resolução de entidades e vinculação de entidades com regras específicas por tipo e códigos de evidência de vocabulário fechado, em vez de suposição de um modelo.

Ambiguidade explícita

HOLD, AMBIGUOUS e NO_CANDIDATE são respostas reais, nunca uma escolha silenciosa.

Verificação cruzada opcional do Google

Junções exatas de IDs (/m/ = P646, /g/ = P2671), relatadas separadamente da prova de identidade.

Lote e evidências

Um resolvedor JSONL retomável com orçamentos de solicitação e um pacote de evidências auditável.

Por que evidências limitadas importam

Um agente que vincula registros a um grafo de conhecimento geralmente precisa de uma resposta: qual entidade é minha? Fazer isso por meio de resultados de pesquisa brutos e despejos completos de declarações custa contexto e convida a erros. "Fox Theatre" corresponde a mais de cem itens do Wikidata; um modelo que lê a primeira página de resultados tende a escolher o primeiro.

Este projeto move a decisão para código determinístico:

  • o resultado da pesquisa é pequeno e diz por que cada candidato correspondeu;
  • o resolvedor precisa de uma âncora local que você forneceu (um site oficial, coordenadas, um endereço, uma data mais um local, um criador) antes de retornar AUTO_MATCH;
  • um nome mais uma cidade geralmente é HOLD, e dois candidatos que ambos se encaixam são AMBIGUOUS;
  • a concordância entre Google e Wikidata é registrada como concordância de provedores, o que diz que os dois provedores descrevem a mesma coisa, não que a coisa é sua.

Consulte Resolução de entidades para as regras e Benchmark para tamanhos medidos e uma demonstração gravada.

Um exemplo de 30 segundos

uvx --from wikidata-google-knowledge-mcp==0.2.1 wdkg resolve "Fox Theatre" --kind place --city Atlanta
# decision HOLD, reasons [NO_LOCAL_ANCHOR], candidate_ids [Q1440190, Q3080199]

uvx --from wikidata-google-knowledge-mcp==0.2.1 wdkg resolve "Fox Theatre" --kind place --city Atlanta \
    --url https://www.foxtheatre.org
# decision AUTO_MATCH, wikidata_qid Q1440190, local anchors [CITY_MATCH, OFFICIAL_HOST_EXACT]

Estes são os resultados de uma execução ao vivo gravada contra o Wikidata.

Ferramentas MCP e CLI

tarefaferramenta MCPCLI
candidatos para um nomekg_searchwdkg search
fatos selecionados de um QIDkg_entitywdkg entity
um relacionamento limitadokg_relatedwdkg related
identidade de um registro localkg_resolvewdkg resolve
centenas ou milhares de registros—wdkg resolve-batch, wdkg export-evidence
configuração e presença de credenciaiskg_statuswdkg status

As ferramentas MCP são para trabalho interativo de uma entidade dentro de uma sessão de agente. Corpora passam pela CLI, que transmite JSONL, pontos de verificação e limita solicitações de provedores. Um núcleo Python atende a ambos, além de uma Skill de Agente portátil que informa ao agente qual usar.

O que não é

  • Não é software oficial da Wikimedia ou do Google, e não é afiliado a nenhum deles.
  • Não é uma exportação do Google Knowledge Graph e não é uma API de locais ou mapas.
  • Não é um oráculo de identidade: AUTO_MATCH significa que uma regra documentada passou nas evidências que você forneceu, e todos os outros resultados são relatados como tal.
  • Somente leitura: nunca edita o Wikidata, o Google ou seus dados.