Project Overview
Description
An open-source Model Context Protocol (MCP) server that revolutionizes access to Greek government transparency data by enabling AI assistants like Claude to intelligently search, retrieve, and analyze official government decisions from the Diavgeia platform. This serverless solution deployed on Cloudflare Workers provides real-time access to public administration data including appointments, budget allocations, procurement, and regulatory decisions.
Purpose
To democratize access to Greek government transparency data by creating an AI-native interface that enables natural language queries, automated analysis, and seamless integration with AI assistants. This project bridges the gap between complex government APIs and everyday citizens, researchers, and journalists who need quick access to public administration information.
Technology Stack
TypeScript
Model Context Protocol
Cloudflare Workers
Axios
Zod
Node.js
Pino Logger
PDF Processing
Biome
Lefthook
Day.js
Key Features
Natural language search across government decisions with advanced filtering
Comprehensive decision retrieval with PDF content extraction
Date-aware query parsing supporting both Greek and English (e.g., "last year", "Ιανουάριος 2024")
Organization and ministry search with automatic name detection
SSE (Server-Sent Events) transport for real-time AI assistant integration
Stdio transport protocol support for Claude Desktop integration
Dual language support (Greek and English) throughout the entire system
PDF document parsing with first 1000 characters preview
Structured data validation using Zod schemas
Comprehensive error handling with user-friendly messages
Rate limiting and respectful API usage patterns
MCP Inspector compatibility for testing and debugging
Cloudflare Workers deployment for global edge performance
Smithery hosting integration for easy MCP server discovery
Complete TypeScript type safety across all modules
Project Gallery