How mounika-nemalipuri/wb_mcp works
A user asks a research question; the LangChain agent reasons with Groq and invokes the local MCP server over stdio. The server validates inputs and dispatches to search, filtering, document lookup, or facet discovery tools. Those tools call the World Bank API client and normalize results through shared utilities before returning structured results for the agent’s answer. The tool-specific modules and agent flow are supported by the README and sampled source; unsampled implementation details are not inferred.
Main entry points: wb_docs_mcp.py MCP tool server · api_client.py World Bank API client · agent_client.py Research agent · search.py Document search
Components 14
Agent experience
- Research agent
client/agent_client.py - MCP client
client/agent_client.py
MCP interface
- MCP tool server
server/wb_docs_mcp.py - Input validation
server/schemas.py
Document operations
- Document search
server/tools/search.py - Structured filtering
server/tools/filter.py - Document metadata
server/tools/document.py - Facet discovery
server/tools/facets.py
API and results
- World Bank API client
server/api_client.py - Result utilities
server/utils.py - API settings
server/config.py
Other components
- Researcher
- Groq model
- World Bank API
Connections 25
- Researcher → Research agent: asks question
- Research agent → Groq model: reasons and selects
- Research agent → MCP client: runs agent
- MCP client → MCP tool server: dispatches tools
- MCP tool server → Input validation: validates inputs
- MCP tool server → Document search: invokes search
- MCP tool server → Structured filtering: invokes filter
- MCP tool server → Document metadata: invokes lookup
- MCP tool server → Facet discovery: invokes discovery
- Document search → World Bank API client: requests documents
- Structured filtering → World Bank API client: requests documents
- Document metadata → World Bank API client: requests metadata
- Facet discovery → World Bank API client: requests facets
- Document search → Result utilities: extracts and formats
- Structured filtering → Result utilities: extracts and formats
- Document metadata → Result utilities: extracts and formats
- Facet discovery → Result utilities: extracts and formats
- World Bank API client → API settings: reads endpoint settings
- Document search → API settings: reads default fields
- Structured filtering → API settings: reads default fields
- World Bank API client → World Bank API: sends HTTP request
- World Bank API → World Bank API client: returns JSON
- MCP tool server → MCP client: returns tool results
- MCP client → Research agent: provides results
- Research agent → Researcher: presents answer