@vespermcp/mcp-server 1.0.0

package/src/python/worldbank_adapter.py

@@ -0,0 +1,99 @@
+import sys
+import json
+import argparse
+import urllib.request
+import urllib.parse
+from datetime import datetime
+
+# WB API for indicators (Series)
+# Source 2 is World Development Indicators
+WB_API_URL = "https://api.worldbank.org/v2/indicator"
+
+def search_worldbank(query: str, limit: int = 10):
+    """
+    Search World Bank indicators.
+    """
+    try:
+        # The World Bank Indicators API doesn't have a direct "search" parameter for indicators 
+        # that works exactly like a search engine. We fetch a page and filter by query terms.
+        # Alternatively, we could use the 'qterm' on the documents API, but indicators are more tabular.
+        
+        params = {
+            "format": "json",
+            "per_page": 299, # Max per page to search through more indicators
+            "source": 2
+        }
+        
+        query_string = urllib.parse.urlencode(params)
+        url = f"{WB_API_URL}?{query_string}"
+        
+        req = urllib.request.Request(url)
+        with urllib.request.urlopen(req) as response:
+            data = json.load(response)
+        
+        # WB response is [metadata, data_list]
+        if len(data) < 2:
+            return []
+            
+        indicators = data[1]
+        
+        results = []
+        count = 0
+        
+        query_terms = query.lower().split()
+        
+        for ind in indicators:
+            name = ind.get('name', '')
+            source_note = ind.get('sourceNote', '')
+            text = (name + " " + source_note).lower()
+            
+            # Simple keyword matching
+            if all(term in text for term in query_terms):
+                metadata = {
+                    "id": f"wb:{ind.get('id')}", 
+                    "source": "worldbank",
+                    "name": name,
+                    "description": source_note or "No description available.",
+                    "downloads": 1000, # Placeholder (high relevance for WB)
+                    "likes": 100,
+                    "last_updated": datetime.utcnow().strftime("%Y-%m-%dT%H:%M:%SZ"),
+                    "quality_score": 95, # Institutional data is high quality
+                    "license": {
+                        "id": "cc-by-4.0",
+                        "name": "Creative Commons Attribution 4.0",
+                        "category": "safe",
+                        "usage_restrictions": [],
+                        "warnings": []
+                    },
+                    "tags": [ind.get('source', {}).get('value')] if ind.get('source') else [],
+                    "total_examples": 0, # Time series length varies
+                    "is_safe_source": True,
+                    "is_structured": True,
+                    "metadata_url": f"https://data.worldbank.org/indicator/{ind.get('id')}",
+                    "domain": "economics"
+                }
+                
+                results.append(metadata)
+                count += 1
+                if count >= limit:
+                    break
+                    
+        return results
+
+    except Exception as e:
+        return {"error": str(e)}
+
+def main():
+    parser = argparse.ArgumentParser(description="World Bank Adapter")
+    parser.add_argument("--action", required=True, choices=["search"])
+    parser.add_argument("--query", required=True)
+    parser.add_argument("--limit", type=int, default=10)
+    
+    args = parser.parse_args()
+    
+    if args.action == "search":
+        results = search_worldbank(args.query, args.limit)
+        print(json.dumps(results))
+
+if __name__ == "__main__":
+    main()