Ocean MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Ocean MCP + Ingestor
Servidor MCP somente leitura e ingestão de dados marítimos brasileiros (condições do mar,
marés, defeso, embarcações, onde vender pescado e base de conhecimento). Alimenta o agente
ocean-agent-api.
O projeto está dividido entre execução local, ingestão automática e hospedagem em nuvem. Qualquer pessoa pode usar o servidor como desenvolvedor, contanto que respeite as fontes, os créditos dos serviços externos e as regras de uso não comercial das APIs.
Componente | Comando | Hospedagem recomendada |
Servidor MCP |
| Render |
Ingestão |
| GitHub Actions |
Banco PostgreSQL | migrations em | Neon ou Supabase |
Busca vetorial | coleção configurada no Qdrant | Qdrant Cloud |
Cache | Redis | Render Key Value ou Redis compatível |
Uso público
O projeto oferece ferramentas MCP de consulta. Ele não altera o estado das fontes externas e não expõe operações de escrita para seus consumidores.
O MCP_AUTH_TOKEN protege o servidor em produção. Quem consumir o MCP precisa enviar o mesmo
Bearer token usado pela API ocean-agent-api. O /health continua público e serve apenas para
confirmar que o processo está operacional.
Related MCP server: Portal da Transparência: Seguro Defeso
Regras do projeto
O servidor é somente leitura: nenhuma ferramenta escreve estado.
O caminho de requisição lê Postgres, Qdrant e cache. Somente fontes ao vivo podem acessar serviços externos, usando timeout, novas tentativas limitadas e fallback para cache marcado como
stale.Toda ferramenta devolve
MaritimeDataResponse(src/ocean/shared/provenance.py), com fonte, data da consulta, momento do dado e limitações.Interpretação determinística, como escala Beaufort e fase da maré, fica em
domain/services. O modelo de linguagem explica o resultado, mas não calcula a regra.servereingestionnunca importam um ao outro. Esse limite arquitetural é verificado pelolint-importsno CI.GFW e Open-Meteo exigem uso não comercial. Verifique os termos das fontes antes de ampliar o projeto ou de oferecer o serviço a terceiros.
Estrutura
src/ocean/
server/ MCP: ferramentas, autenticação, /health
ingestion/ jobs, parsers, coletores
domain/ modelos e serviços de interpretação
retrieval/ vector (Qdrant) e structured (Postgres)
storage/ postgres (conexão, migrações, execuções), cache (Redis)
shared/ config, logging, http, proveniência
migrations/ SQL do esquema (a ingestão é a dona do esquema)
content/knowledge/ documentos do RAG (Markdown com cabeçalho)
data/ tabelas curadas (CSV)
tests/Primeiros passos
python -m venv .venv
.\.venv\Scripts\Activate.ps1 # Windows PowerShell
# source .venv/bin/activate # Linux/macOS
pip install -e ".[server,ingest,dev]"
Copy-Item .env.example .env # Windows
# cp .env.example .env # Linux/macOSEdite o .env com as credenciais próprias. Nunca faça commit desse arquivo.
Use os nomes da seção "Variáveis de ambiente" abaixo.
pytest -q
ruff check .
lint-importsUse Python 3.12 no desenvolvimento, na imagem Docker e no GitHub Actions.
Depois da primeira instalação bem-sucedida, fixe o ambiente com
pip freeze > constraints.txt.
Variáveis de ambiente
Crie valores próprios em cada provedor. Não reutilize credenciais do repositório.
Variável | Uso |
| Protege o servidor MCP em produção |
| Banco PostgreSQL acessado localmente ou pelo servidor |
| URL direta do Neon, quando fornecida pelo provedor |
| Cache Redis |
| Endpoint da instância Qdrant |
| Chave da instância Qdrant |
| Coleção padrão, por exemplo |
| Conta usada para embeddings |
| Token Cloudflare com acesso ao modelo |
Variáveis reservadas à ingestão
No GitHub Actions, configure estes secrets em Settings → Secrets and variables → Actions:
DATABASE_URL_ADMINQDRANT_URLQDRANT_API_KEYCLOUDFLARE_ACCOUNT_IDCLOUDFLARE_API_TOKEN
DATABASE_URL_ADMIN é a URL de um usuário administrativo do PostgreSQL. Ela é usada somente
pelo workflow de ingestão e pelas migrations. O servidor público deve usar preferencialmente
DATABASE_URL associado a um usuário somente leitura.
Rodar o servidor local
python -m ocean.server # http://localhost:8000 (/health, MCP em /mcp)Verifique a instalação:
curl http://localhost:8000/healthResposta esperada:
{"status":"ok"}Indexar a base de conhecimento
python -m ocean.ingestion.run knowledge_refreshOs arquivos de content/knowledge/*.md vêm marcados revisado: nao: são rascunhos a revisar com fonte oficial.
A coleção padrão é ocean_conhecimento (não mexe na coleção antiga conhecimento_maritimo).
Banco de dados local ou no Neon
Copie a URL PostgreSQL fornecida pelo painel do Neon ou Supabase para DATABASE_URL no .env.
Em conexões externas, normalmente a URL inclui sslmode=require.
python -m ocean.storage.postgres.migrate # aplica migrations/*.sql
python -m ocean.ingestion.run ping # confere a conexão e registra uma execuçãoApós configurar o segredo DATABASE_URL_ADMIN, os mesmos migrations e jobs podem rodar pelo
workflow Ingestão em Actions → Ingestão → Run workflow.
Ferramentas MCP
Ferramenta | Situação |
| implementadas (aliases temporários: |
| fase 2 |
| fase 3 |
| fase 4 |
| fase 5 |
Deploy
Servidor MCP no Render
Clique em New → Blueprint.
Selecione o repositório e o arquivo
render.yaml.Preencha todas as variáveis marcadas
sync: false.Defina
MCP_AUTH_TOKENcom o mesmo valor usado pela API consumidora.Configure
DATABASE_URLcom uma conta PostgreSQL somente leitura.Aguarde o health check em
/health.
Na API separada ocean-agent-api, configure MCP_SERVER_URL com o endereço público do MCP
e ALLOWED_TOOLS com a lista de ferramentas disponíveis.
Banco no Neon
O Neon pode hospedar o PostgreSQL usado pelo projeto.
npm i -g neon@latest
neon login
neon init -y --org-id <org-id> --project-id <project-id> --branch production --services postgres
neon deployO Neon grava as variáveis da branch no .env local ou .env.local.
Nunca copie as credenciais para o repositório ou para comentários.
Ingestão no GitHub Actions
Crie os secrets administrativos descritos acima e execute Actions → Ingestão → Run workflow, escolhendo o job desejado.
Documentação
Visão do projeto e guia técnico (decisões, contrato, plano por fases): documentos "Ocean — Visão do Projeto" e "Ocean — Guia Técnico".
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
AI-powered commodity price forecasts and Brazil trade intelligence via MCP. Access Brazilian exports and imports from MDIC/ComexStat since 2000, by HS4, HS6 and NCM code, partner country, USD FOB and kilograms — plus crop production, supply & demand, climate data and production forecasts for major commodities including soybeans, coffee, corn, beef and cocoa. Compare trade flows, markets, countries and time periods with like-for-like windows. Every answer identifies the measurement period and data source. 15 read-only tools. Metered in credits. Connect directly via Streamable HTTP — no installation required: https://mcp.kyrodata.com/mcp Authentication: Bearer key or OAuth 2.1 (PKCE). Official MCP registry: com.kyrodata/kyrodata
Brazilian legal stack in one MCP: lawsuits, court publications, case law, tenders, certificates.
Read-only MCP tools for public works, builders, ratings, timelines and nearby services in Brazil.
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to official Brazilian real estate registration data (ONR) via a single tool. Works with any MCP client over HTTP, with prepaid pay-per-use billing.MIT
- AlicenseNot gradedqualityDmaintenanceRead-only MCP server enabling querying official Brazilian transparency data on Seguro Defeso (fishermen's insurance) via a single tool, with prepaid pay-per-use credits.MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying the Brazilian government's transparency portal (Portal da Transparência) to search official public spending and transparency data. Read-only access via natural language from any MCP client, with prepaid pay-per-query usage.MIT
- FlicenseCqualityBmaintenanceEnables read-only access to official Brazilian government procurement data from Compras.gov.br and the PNCP, covering all cataloged public GET endpoints through MCP tools.1751-