Spaces:
Running
Running
Update README - 4 MCP servers (removed Astroseek)
Browse filesChanges:
- Updated server count: 5 โ 4
- Removed Astroseek references throughout
- Updated architecture diagram
- Cleaner documentation
MCP servers: Local, Modal, Astro.com, Gemini AI
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 |
-
###
|
| 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.
|
| 50 |
-
4.
|
| 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 (
|
| 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 โ โ
|
| 110 |
โ MCP โ โ MCP โ โ MCP โ โ AI MCP โ
|
| 111 |
โโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโโโโ
|
| 112 |
โ โ โ โ
|
| 113 |
-
Fast & Scalable Cloud
|
| 114 |
-
Reliable Calculations
|
| 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**:
|
| 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.
|
| 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 |
-
**
|
| 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** (
|
| 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
|
| 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
|