atlas2-mcp/PROJECT.md

atlas2-mcp — project notes

Goal

Implement the atlas2 resolution tool as an MCP server.

Tool contract (resolve)

Based on resolve_scheme.md: 1) Input: resolve("Joe Biden") 2) Cache lookup: alias index + identifier index 3) If hit:

• load RDF -> Python model 4) If miss:
• call Wikidata
• build Entity
• store in RDF
• update cache 5) Return JSON

Where code lives

• app/mcp_server.py — MCP tool registration (resolve)
• app/main.py — FastAPI + HTTP/SSE mount at /mcp
• app/resolve.py — resolve service (currently stubbed)
• app/atlas_store.py — SPARQL persistence (SPARQL endpoint OR Virtuoso MCP tools)

Next steps

1) Replace the stub in app/resolve.py with the cache + resolve flow. 2) Implement alias/identifier indexes. 3) Wire Wikidata calls + RDF storage using atlas_store.py.