How sepehr071/amar-mcp works
amar-mcp is a read-only MCP server that exposes Iran’s Statistical Centre data to AI clients. The main workflow is an MCP tool request, server dispatch, retrieval of catalog pages or files, and parsing into compact JSON. The graph separates catalog/news/calendar, statistical data tools, macroeconomic tools, and shared transport/registration. README-documented capabilities are included, but unsampled tool implementations are represented at their existing module paths; edges are limited to relationships shown in the excerpts or README.
Main entry points: server.py MCP server · http.py HTTP client · site.py Release details · data.py CPI inflation
Components 17
MCP entry
- MCP server
src/amar_mcp/server.py - Tool registry
src/amar_mcp/registry.py
Portal catalog
- Release search
src/amar_mcp/site.py - Release details
src/amar_mcp/site.py - Publishing calendar
src/amar_mcp/site.py - News reader
src/amar_mcp/site.py
Statistical data
- CPI inflation
src/amar_mcp/data.py - Labour force
src/amar_mcp/data.py - Census population
src/amar_mcp/data.py - Excel table reader
src/amar_mcp/data.py
Macro data
- Macro indicators
src/amar_mcp/macro.py - GDP growth
src/amar_mcp/macro.py - Producer prices
src/amar_mcp/macro.py
Shared infrastructure
- HTTP client
src/amar_mcp/http.py
Other components
- MCP client
- amar.org.ir
- Excel workbooks
Connections 36
- MCP client → MCP server: calls tools
README.md - MCP server → Tool registry: registers tools
src/amar_mcp/server.py - MCP server → Release search: dispatches
src/amar_mcp/server.py - MCP server → Release details: dispatches
src/amar_mcp/server.py - MCP server → Publishing calendar: dispatches
src/amar_mcp/server.py - MCP server → News reader: dispatches
src/amar_mcp/server.py - MCP server → CPI inflation: dispatches
src/amar_mcp/server.py - MCP server → Labour force: dispatches
src/amar_mcp/server.py - MCP server → Census population: dispatches
src/amar_mcp/server.py - MCP server → Excel table reader: dispatches
src/amar_mcp/server.py - MCP server → Macro indicators: dispatches
src/amar_mcp/server.py - MCP server → GDP growth: dispatches
src/amar_mcp/server.py - MCP server → Producer prices: dispatches
src/amar_mcp/server.py - Release search → HTTP client: fetches pages
src/amar_mcp/site.py - Release details → HTTP client: fetches pages
src/amar_mcp/site.py - Publishing calendar → HTTP client: fetches calendar
src/amar_mcp/site.py - News reader → HTTP client: fetches news
src/amar_mcp/site.py - CPI inflation → HTTP client: downloads files
src/amar_mcp/data.py - Labour force → HTTP client: downloads files
src/amar_mcp/data.py - Census population → HTTP client: downloads files
src/amar_mcp/data.py - Excel table reader → HTTP client: downloads files
src/amar_mcp/data.py - CPI inflation → Release details: loads release
src/amar_mcp/data.py - Excel table reader → Release details: loads release
src/amar_mcp/data.py - Macro indicators → HTTP client: downloads files
src/amar_mcp/macro.py - Macro indicators → Release details: finds workbook
src/amar_mcp/macro.py - GDP growth → HTTP client: downloads files
src/amar_mcp/macro.py - GDP growth → Release details: finds workbook
src/amar_mcp/macro.py - Producer prices → HTTP client: downloads files
src/amar_mcp/macro.py - Producer prices → Release details: finds workbook
src/amar_mcp/macro.py - HTTP client → amar.org.ir: requests data
README.md - HTTP client → Excel workbooks: downloads files
README.md - Excel table reader → Excel workbooks: parses sheets
src/amar_mcp/data.py - CPI inflation → Excel workbooks: parses CPI
src/amar_mcp/data.py - Macro indicators → Excel workbooks: parses indicators
src/amar_mcp/macro.py - GDP growth → Excel workbooks: parses GDP
src/amar_mcp/macro.py - Producer prices → Excel workbooks: parses PPI
src/amar_mcp/macro.py