Basemap MCP Server
cognis-digital/basemap
Catálogo estruturado de instalações com consultas geoespaciais via MCP
Ver no GitHubMCP server para construir e consultar catálogos estruturados de instalações e áreas de interesse (AOIs) com capacidades de busca por distância, setor e cobertura. Ferramenta self-hostable que integra com agentes de IA para análise geoespacial e priorização de resultados.
Instalação
npx convez-ai cognis-digital/basemap1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Indexação e consulta de instalações/AOIs com métricas de distância e setor
- Integração de análise geoespacial em workflows de agentes de IA
- Priorização automática de resultados em sistemas de detecção
Veredito

Ferramenta especializada em catálogos geoespaciais via MCP, bem estruturada para integração com agentes de IA. Recomendada para sistemas que precisam consultar instalações/AOIs com análise de distância e cobertura.
README
A tradução para o português deste README ainda está na fila.
BASEMAP
Build and query a structured catalog of installations/AOIs with distance, sector, and coverage queries.
Part of the Cognis Neural Suite.
pip install cognis-basemap
basemap scan . # → prioritized findings in seconds
Contents
- Why basemap? · Features · Quick start · Example · Architecture · AI stack · How it compares · Integrations · Install anywhere · Related · Contributing
Why basemap?
Build and query a structured catalog of installations/AOIs with distance, sector, and coverage queries. — without standing up heavyweight infrastructure.
basemap is single-purpose, scriptable, and self-hostable: point it at a target, get prioritized results in the format your workflow already speaks (table · JSON · SARIF), gate CI on it, and let agents drive it over MCP.
Features
- ✅ Haversine Km
- ✅ Initial Bearing Deg
- ✅ Bearing To Sector
- ✅ Runs on Linux/macOS/Windows · Docker · devcontainer
- ✅ Ports in Python, JavaScript, Go, and Rust (
ports/)
Quick start
pip install cognis-basemap
basemap --version
basemap scan . # scan current project
basemap scan . --format json # machine-readable
basemap scan . --fail-on high # CI gate (non-zero exit)
Example
$ basemap scan .
[HIGH ] BAS-001 example finding (./src/app.py)
[MEDIUM ] BAS-002 another signal (./config.yaml)
2 findings · risk score 5 · 38ms
Architecture
flowchart LR
A[Input: file / dir / API] --> B[Collectors]
B --> C[Rules / Analyzers]
C --> D[Scorer]
D --> E{Reporters}
E --> F[Table]
E --> G[JSON / SARIF]
E --> H[MCP tool -. drives .-> AI agents]
Use it from any AI stack
basemap is interoperable with every popular way of using AI:
- MCP server —
basemap mcp(Claude Desktop, Cursor, Cognis.Studio, uncensored-fleet) - OpenAI-compatible / JSON — pipe
basemap scan . --format jsoninto any agent or LLM - LangChain · CrewAI · AutoGen · LlamaIndex — wrap the CLI/JSON as a tool in one line
- CI / scripts — exit codes + SARIF for non-AI pipelines
How it compares
| Cognis basemap | typical tools | |
|---|---|---|
| Self-hostable, no account | ✅ | varies |
| Single command, zero config | ✅ | ⚠️ |
| JSON + SARIF for CI | ✅ | varies |
| MCP-native (AI agents) | ✅ | ❌ |
| Polyglot ports (JS/Go/Rust) | ✅ | ❌ |
| Open license | ✅ COCL | varies |
Integrations
Pipes into your stack: SARIF for code-scanning, JSON for anything, an MCP server (basemap mcp) for AI agents, and a webhook forwarder for SIEM/Slack/Jira. See docs/INTEGRATIONS.md.
Install — every way, every platform
pip install "git+https://github.com/cognis-digital/basemap.git" # pip (works today)
pipx install "git+https://github.com/cognis-digital/basemap.git" # isolated CLI
uv tool install "git+https://github.com/cognis-digital/basemap.git" # uv
pip install cognis-basemap # PyPI (when published)
docker run --rm ghcr.io/cognis-digital/basemap:latest --help # Docker
brew install cognis-digital/tap/basemap # Homebrew tap
curl -fsSL https://raw.githubusercontent.com/cognis-digital/basemap/main/install.sh | sh
| Linux | macOS | Windows | Docker | Cloud |
|---|---|---|---|---|
scripts/setup-linux.sh | scripts/setup-macos.sh | scripts/setup-windows.ps1 | docker run ghcr.io/cognis-digital/basemap | DEPLOY.md (AWS/Azure/GCP/k8s) |
Related Cognis tools
Explore the suite → 🗂️ all 170+ tools · ⭐ awesome-cognis · 🔗 cognis-sources · 🤖 uncensored-fleet · 🧠 hermes
Contributing
PRs, new rules, and demo scenarios are welcome under the collaboration-pull model — see CONTRIBUTING.md and SECURITY.md.
⭐ If
basemapsaved you time, star it — it genuinely helps others find it.
License
Source-available under the Cognis Open Collaboration License (COCL) v1.0 — free for personal, internal-evaluation, research, and educational use; commercial / production use requires a license (licensing@cognis.digital). See LICENSE.