neo0-mcp
Neo0ai/neo0-mcp
Coordinate-based semantic addressing for AI agents, over the Model Context Protocol
Instalação
npx convez-ai Neo0ai/neo0-mcp1 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
README
A tradução para o português deste README ainda está na fila.
Neo0 MCP
🚀 Try the live demo · 📄 Read the whitepaper
Coordinate-based semantic addressing for AI agents, exposed over the Model Context Protocol (MCP).
Neo0 assigns every concept an immutable coordinate address in a recursively partitioned semantic space. Concepts that are close in meaning share a coordinate prefix, so the address itself encodes meaning, location, and routing — no separate ontology graph required.
This repository is the open MCP shell. It exposes Neo0's tools to any MCP client (Claude and others) and forwards each call to the Neo0 engine API. The engine itself — coordinate derivation, the immutable registry, persona control — runs as a hosted service and is not included here.
Architecture
MCP client (Claude) ─▶ neo0-mcp (this repo, :8000) ──HTTP──▶ Neo0 engine API (hosted)
The shell holds no engine logic, model weights, or data. It only formats requests and responses; all computation happens behind the engine API. Forking this repository gives you the interface, not the engine.
Tools
| Tool | Description |
|---|---|
neo0_info | Engine overview and load status |
derive_address | Immutable coordinate address + prefix region for a concept |
search | k nearest concepts, each with its address |
semantic_region | Members of a prefix region |
verify_address | Tamper check by re-deriving from the minting-time basis |
prefix_proximity | Prefix-match length + cosine similarity between two concepts |
persona | Region characteristic concepts + coherence-based control parameters |
compose_persona | Model × persona composition — coming soon |
Quick start
pip install -r requirements.txt
cp .env.example .env # then set NEO0_API_URL and NEO0_API_KEY
python server.py
The server speaks streamable-HTTP MCP on port 8000 at path /mcp.
Use with Claude
In Claude: Settings → Connectors → Add custom connector, then enter your server URL ending in /mcp.
Configuration
| Variable | Description |
|---|---|
NEO0_API_URL | Neo0 engine API base URL |
NEO0_API_KEY | Engine API key |
License
This MCP shell is licensed under Apache-2.0 (see LICENSE).
The Neo0 coordinate engine is patent-pending and provided as a hosted API under separate terms. Use of the API includes a license to the relevant patents; independently reimplementing the engine is not covered by this repository's license.
Built by Neo0 — https://neo0.ai