OpenGov MCP Server

Acesse as APIs de Dados Abertos Socrata de portais de dados governamentais.

Documentação

OpenGov MCP Server

Um servidor MCP (Model Context Protocol) que permite que clientes MCP, como o Claude Desktop, acessem as Socrata Open Data APIs. Essa integração permite que o Claude Desktop pesquise, recupere e analise conjuntos de dados públicos de portais de dados governamentais.

Visão Geral

Este servidor MCP fornece acesso a dados abertos de qualquer portal de dados com tecnologia Socrata, incluindo aqueles de cidades, estados e agências federais, como:

Nenhuma chave de API é necessária para uso básico, pois o servidor acessa dados públicos.

Recursos

Com este servidor MCP, os clientes podem:

Pesquisar e descobrir conjuntos de dados por palavra-chave, categoria ou tags
Visualizar metadados do conjunto de dados e informações das colunas
Executar consultas semelhantes a SQL para recuperar e analisar dados
Obter estatísticas de uso do portal

Instalação para o Claude Desktop

Configuração rápida com npx (Recomendado)

A maneira mais fácil de usar este servidor MCP é com npx, que não requer nenhuma instalação:

Crie ou edite sua configuração do Claude Desktop:

Crie ou edite claude_desktop_config.json no seu diretório inicial:

{
  "mcpServers": { 
    "opengov": {
      "command": "npx",
      "args": ["-y", "opengov-mcp-server@latest"],
      "env": {
        "DATA_PORTAL_URL": "https://data.cityofchicago.org"
      }
    }
  }
}

Você pode substituir o DATA_PORTAL_URL por qualquer portal de dados com tecnologia Socrata.

Reinicie o Claude Desktop (se já estiver em execução)
Comece a usar o servidor MCP:

No Claude Desktop, agora você pode fazer perguntas como:
```
How many cars were towed in Chicago this month?
```
e você pode fazer perguntas de acompanhamento que aprofundam os detalhes:
```
Which make and color were towed the most?
Also, were there any interesting vanity plates?
```
Na primeira vez que você executar uma consulta, o npx baixará e executará automaticamente a versão mais recente do servidor.

Instalação manual a partir do código-fonte

Se você preferir executar a partir do código-fonte (para desenvolvimento ou personalização):

Clone este repositório:

git clone https://github.com/srobbin/opengov-mcp-server.git
cd opengov-mcp-server

Instale as dependências e compile:
```
npm install
npm run build
```

Crie a configuração do Claude Desktop:

Crie ou edite claude_desktop_config.json no seu diretório inicial:

{
  "mcpServers": { 
    "opengov": {
      "command": "node",
      "args": [
        "/path/to/your/opengov-mcp-server/dist/index.js"
      ],
      "env": {
        "DATA_PORTAL_URL": "https://data.cityofchicago.org"
      }
    }
  }
}

Substitua /path/to/your/opengov-mcp-server pelo caminho real onde você clonou o repositório.

Reinicie o Claude Desktop (se já estiver em execução)

Ferramenta disponível: get_data

Este servidor MCP fornece uma ferramenta unificada get_data que o Claude Desktop usa para acessar dados da Socrata.

Parâmetros

type (string, obrigatório): Tipo de operação
- catalog: Pesquisar e listar conjuntos de dados
- categories: Listar categorias de conjuntos de dados
- tags: Listar tags de conjuntos de dados
- dataset-metadata: Obter detalhes do conjunto de dados
- column-info: Obter informações das colunas do conjunto de dados
- data-access: Consultar e recuperar registros
- site-metrics: Obter estatísticas do portal
domain (string, opcional): Nome do host do portal de dados (sem protocolo)
query (string, opcional): Consulta de pesquisa para conjuntos de dados
datasetId (string): Identificador do conjunto de dados para operações específicas
soqlQuery (string, opcional): Consulta SoQL para filtrar dados
limit (número, opcional): Número máximo de resultados a retornar (padrão: 10)
offset (número, opcional): Resultados a pular para paginação (padrão: 0)

Exemplos de consultas

Estes são exemplos de como o Claude Desktop formatará consultas para o servidor MCP:

// Find datasets about budgets
{
  "type": "catalog",
  "query": "budget",
  "limit": 5
}

// Get information about a dataset
{
  "type": "dataset-metadata",
  "datasetId": "6zsd-86xi"
}

// Query dataset records with SQL-like syntax
{
  "type": "data-access",
  "datasetId": "6zsd-86xi",
  "soqlQuery": "SELECT * WHERE amount > 1000 ORDER BY date DESC",
  "limit": 10
}

Opções de configuração

O servidor requer uma variável de ambiente:

DATA_PORTAL_URL: A URL do portal de dados da Socrata (por exemplo, https://data.cityofchicago.org)

Isso pode ser definido:

Na configuração do Claude Desktop (recomendado)
Nas suas variáveis de ambiente
Pela linha de comando: DATA_PORTAL_URL=https://data.cityofchicago.org opengov-mcp-server