aamanlamba commited on
Commit
355fd0e
ยท
verified ยท
1 Parent(s): c234230

Update README - 4 MCP servers (removed Astroseek)

Browse files

Changes:
- Updated server count: 5 โ†’ 4
- Removed Astroseek references throughout
- Updated architecture diagram
- Cleaner documentation

MCP servers: Local, Modal, Astro.com, Gemini AI

Files changed (1) hide show
  1. README.md +12 -21
README.md CHANGED
@@ -40,15 +40,14 @@ Combine 2000-year-old Hellenistic astrology techniques with cutting-edge MCP inf
40
  - **Teaches** using AI-powered explanations
41
  - **Preserves** ancient wisdom with source citations
42
 
43
- ### 5 MCP Servers, One Unified Interface
44
 
45
  HERMES showcases MCP's power by integrating:
46
 
47
  1. ๐Ÿ  **Local MCP** - Core calculations (instant, offline)
48
  2. โ˜๏ธ **Modal Serverless** - Advanced time-lords (scalable cloud)
49
- 3. ๐Ÿ”ฎ **Astroseek.com** - External charts (web scraping)
50
- 4. ๐Ÿ“Š **Astro.com** - Classical charts (Hellenistic rendering)
51
- 5. ๐Ÿค– **Gemini AI** - Natural language teaching (conversational)
52
 
53
  ## ๐ŸŽฏ What is Hellenistic Astrology?
54
 
@@ -75,11 +74,10 @@ Unlike modern psychological astrology, Hellenistic astrology (1st-7th century CE
75
  - โœ… **Bounds & Decans** - Egyptian bounds and Chaldean decan rulers
76
  - โœ… **Fixed Stars** - 15 major fixed stars with conjunctions
77
 
78
- **MCP Architecture (5 Servers):**
79
 
80
  - โœ… **Local MCP Server** (`hermes_local_mcp.py`) - Instant offline calculations
81
  - โœ… **Modal Serverless MCP** (`mcp_server.py`) - Cloud-deployed functions
82
- - โœ… **Astroseek Integration** (`astroseek_mcp.py`) - External chart data
83
  - โœ… **Astro.com Integration** (`astrodienst_mcp.py`) - Classical Hellenistic charts
84
  - โœ… **Gemini AI MCP** (`gemini_mcp.py`) - Natural language conversations
85
 
@@ -106,12 +104,12 @@ Unlike modern psychological astrology, Hellenistic astrology (1st-7th century CE
106
  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
107
  โ”‚ โ”‚ โ”‚ โ”‚
108
  โ”Œโ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”
109
- โ”‚ Local โ”‚ โ”‚ Modal Serverless โ”‚ โ”‚ Astroseek โ”‚ โ”‚ Gemini โ”‚
110
  โ”‚ MCP โ”‚ โ”‚ MCP โ”‚ โ”‚ MCP โ”‚ โ”‚ AI MCP โ”‚
111
  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
112
  โ”‚ โ”‚ โ”‚ โ”‚
113
- Fast & Scalable Cloud External Chart AI-Powered
114
- Reliable Calculations Integration Teaching
115
  ```
116
 
117
  ### Technology Stack
@@ -122,7 +120,7 @@ Reliable Calculations Integration Teaching
122
  - **AI Models**: Google Gemini (teaching), fallback responses
123
  - **Ephemeris**: Swiss Ephemeris (pyswisseph)
124
  - **Hosting**: HuggingFace Spaces
125
- - **External APIs**: Astroseek.com, Astro.com integration
126
 
127
  ### MCP Server Details
128
 
@@ -138,19 +136,13 @@ Reliable Calculations Integration Teaching
138
  - 6 functions: ZR, firdaria, bounds, decans, stars, dignities
139
  - Auto-scaling with generous free tier
140
 
141
- **3. Astroseek MCP** (`astroseek_mcp.py`):
142
-
143
- - Chart data via web scraping
144
- - City/country geocoding
145
- - Rate-limited (1 req/sec)
146
-
147
- **4. Astro.com MCP** (`astrodienst_mcp.py`):
148
 
149
  - Classical Hellenistic chart URLs
150
  - Whole Sign house system
151
  - Interpretation guides
152
 
153
- **5. Gemini AI MCP** (`gemini_mcp.py`):
154
 
155
  - Natural language Q&A
156
  - Classical source citations
@@ -254,7 +246,7 @@ Formula: Asc + Moon - Sun = 0 + 180 - 45 = 135ยฐ (15ยฐ Leo)
254
 
255
  - โœ… **Multi-Tier Architecture** demonstrating MCP's power
256
  - โœ… **Serverless Integration** (Modal cloud functions)
257
- - โœ… **External APIs** (Astroseek, Astro.com)
258
  - โœ… **AI Teaching** (Gemini with source citations)
259
 
260
  **3. Unique Value Proposition**
@@ -422,12 +414,11 @@ For full functionality in Phase 2+:
422
 
423
  ### Phase 2: MCP Integration โœ… COMPLETE (Nov 18-28)
424
 
425
- - [x] Build 5 Python MCP servers
426
  - [x] Deploy Modal serverless (6 functions)
427
  - [x] Local MCP server (dignities, profections, lots)
428
  - [x] Astro.com MCP integration (classical charts)
429
  - [x] Gemini AI MCP (natural language teaching)
430
- - [x] Astroseek MCP integration (city/country geocoding)
431
  - [x] Zodiacal releasing calculator
432
  - [x] Firdaria time-lord system
433
  - [x] Bounds and decans tables
 
40
  - **Teaches** using AI-powered explanations
41
  - **Preserves** ancient wisdom with source citations
42
 
43
+ ### 4 MCP Servers, One Unified Interface
44
 
45
  HERMES showcases MCP's power by integrating:
46
 
47
  1. ๐Ÿ  **Local MCP** - Core calculations (instant, offline)
48
  2. โ˜๏ธ **Modal Serverless** - Advanced time-lords (scalable cloud)
49
+ 3. ๐Ÿ“Š **Astro.com** - Classical charts (Hellenistic rendering)
50
+ 4. ๐Ÿค– **Gemini AI** - Natural language teaching (conversational)
 
51
 
52
  ## ๐ŸŽฏ What is Hellenistic Astrology?
53
 
 
74
  - โœ… **Bounds & Decans** - Egyptian bounds and Chaldean decan rulers
75
  - โœ… **Fixed Stars** - 15 major fixed stars with conjunctions
76
 
77
+ **MCP Architecture (4 Servers):**
78
 
79
  - โœ… **Local MCP Server** (`hermes_local_mcp.py`) - Instant offline calculations
80
  - โœ… **Modal Serverless MCP** (`mcp_server.py`) - Cloud-deployed functions
 
81
  - โœ… **Astro.com Integration** (`astrodienst_mcp.py`) - Classical Hellenistic charts
82
  - โœ… **Gemini AI MCP** (`gemini_mcp.py`) - Natural language conversations
83
 
 
104
  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
105
  โ”‚ โ”‚ โ”‚ โ”‚
106
  โ”Œโ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”
107
+ โ”‚ Local โ”‚ โ”‚ Modal Serverless โ”‚ โ”‚ Astro.com โ”‚ โ”‚ Gemini โ”‚
108
  โ”‚ MCP โ”‚ โ”‚ MCP โ”‚ โ”‚ MCP โ”‚ โ”‚ AI MCP โ”‚
109
  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
110
  โ”‚ โ”‚ โ”‚ โ”‚
111
+ Fast & Scalable Cloud Classical Chart AI-Powered
112
+ Reliable Calculations Generation Teaching
113
  ```
114
 
115
  ### Technology Stack
 
120
  - **AI Models**: Google Gemini (teaching), fallback responses
121
  - **Ephemeris**: Swiss Ephemeris (pyswisseph)
122
  - **Hosting**: HuggingFace Spaces
123
+ - **External APIs**: Astro.com integration
124
 
125
  ### MCP Server Details
126
 
 
136
  - 6 functions: ZR, firdaria, bounds, decans, stars, dignities
137
  - Auto-scaling with generous free tier
138
 
139
+ **3. Astro.com MCP** (`astrodienst_mcp.py`):
 
 
 
 
 
 
140
 
141
  - Classical Hellenistic chart URLs
142
  - Whole Sign house system
143
  - Interpretation guides
144
 
145
+ **4. Gemini AI MCP** (`gemini_mcp.py`):
146
 
147
  - Natural language Q&A
148
  - Classical source citations
 
246
 
247
  - โœ… **Multi-Tier Architecture** demonstrating MCP's power
248
  - โœ… **Serverless Integration** (Modal cloud functions)
249
+ - โœ… **External APIs** (Astro.com)
250
  - โœ… **AI Teaching** (Gemini with source citations)
251
 
252
  **3. Unique Value Proposition**
 
414
 
415
  ### Phase 2: MCP Integration โœ… COMPLETE (Nov 18-28)
416
 
417
+ - [x] Build 4 Python MCP servers
418
  - [x] Deploy Modal serverless (6 functions)
419
  - [x] Local MCP server (dignities, profections, lots)
420
  - [x] Astro.com MCP integration (classical charts)
421
  - [x] Gemini AI MCP (natural language teaching)
 
422
  - [x] Zodiacal releasing calculator
423
  - [x] Firdaria time-lord system
424
  - [x] Bounds and decans tables