basedosdados/mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

6 stars 1 forks 품질 70 트렌드 28

Repository Install

Servidor MCP da Base dos Dados

개요

Servidor MCP (Model Context Protocol) que expõe a API da Base dos Dados como ferramentas para agentes de IA. - — busca e consulta de metadados públicos. Não requer conta. - — execução de queries SQL nas tabelas públicas via BigQuery. Requer conta GCP. - — criação e atualização de metadados no backend. Requer conta BD. Permite buscar conjuntos e consultar metadados sem qualquer autenticação. Permite executar queries SQL nas tabelas públicas da Base dos Dados via BigQuery. - Python 3.11+ - Conta no Google Cloud Platform (GCP) com um projeto criado - gcloud CLI instalado e autenticado: As queries são cobradas ao seu projeto GCP. Forneça o projeto de faturamento em ordem de prioridade: 1. Parâmetro billing_project na chamada da ferramenta 2. Variável de ambiente GCP_PROJECT_ID 3. Campo gcp_project em ~/.basedosdados/credentials.json: Permite criar e atualizar metadados de conjuntos, tabelas, colunas e demais entidades no backend da Base dos Dados.

README

원문 README의 일부입니다. 원문 보기.

databasis-mcp

Servidor MCP (Model Context Protocol) que expõe a API da Base dos Dados como ferramentas para agentes de IA.

Oferece três conjuntos de ferramentas:

Consumo de metadados — busca e consulta de metadados públicos. Não requer conta.
Consumo de dados — execução de queries SQL nas tabelas públicas via BigQuery. Requer conta GCP.
Cadastro de dados — criação e atualização de metadados no backend. Requer conta BD.

Consumo de metadados

Permite buscar conjuntos e consultar metadados sem qualquer autenticação.

Ferramentas disponíveis

Ferramenta	Descrição
`search_datasets`	Busca conjuntos por nome
`list_datasets`	Lista conjuntos, opcionalmente filtrado por organização
`get_dataset`	Retorna metadados completos de um conjunto, incluindo referências BigQuery
`lookup_id`	Busca ID de uma entidade de referência por slug
`discover_ids`	Resolve slugs → IDs de referência (áreas, entidades, etc.)
`get_raw_data_sources`	Lista fontes brutas de um conjunto

Exemplo de uso

1. search_datasets("educação") → encontra conjuntos relevantes
2. get_dataset("br_inep_censo_escolar") → vê tabelas disponíveis e referências BigQuery

Consumo de dados

Permite executar queries SQL nas tabelas públicas da Base dos Dados via BigQuery.

Requisitos

Python 3.11+
Conta no Google Cloud Platform (GCP) com um projeto criado
gcloud CLI instalado e autenticado:

gcloud auth application-default login

Ferramentas disponíveis

Ferramenta	Descrição
`preview_table`	Visualiza as primeiras linhas de uma tabela via BigQuery
`query_bigquery`	Executa SQL nas tabelas `basedosdados.*` no BigQuery

Projeto de faturamento GCP

As queries são cobradas ao seu projeto GCP. Forneça o projeto de faturamento em ordem de prioridade:

Parâmetro billing_project na chamada da ferramenta
Variável de ambiente GCP_PROJECT_ID
Campo gcp_project em ~/.basedosdados/credentials.json:

{
  "gcp_project": "meu-projeto-gcp"
}

Exemplo de uso

1. get_dataset("br_inep_censo_escolar") → vê referências BigQuery (gcp_dataset_id, gcp_table_id)
2. preview_table("br_inep_censo_escolar", "escola") → visualiza as primeiras linhas
3. query_bigquery("SELECT uf, COUNT(*) as n FROM `basedosdados.br_inep_censo_escolar.escola` GROUP BY uf LIMIT 10")

Cadastro de dados

GitHub에서 전체 README 보기

설치

uvx --from git+https://github.com/basedosdados/mcp databasis-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "databasis": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/basedosdados/mcp", "databasis-mcp"]
    }
  }
}