hasecon/mcp-astronomical-time-server

🌟 MCP Astronomical Time Server

Een krachtige Model Context Protocol (MCP) server die geavanceerde tijd, astronomie, feestdagen en productiviteits-functionaliteiten biedt. Perfect voor internationale teams, fotografen, reisplanners en productiviteits-enthusiasten!

✨ Features

⏰ Tijd & Timezone Management

• 🌍 Wereldklok voor meerdere tijdzones
• 🔄 Timezone conversies
• ⏱️ Countdown timers en event planning
• 📅 Nauwkeurige tijd berekeningen tussen datums

☀️ Astronomische Berekeningen

• 🌅 Zonsopgang en zonsondergang tijden
• 🌞 Zonnestand tracking (azimuth & hoogte)
• 📸 Golden Hour en Blue Hour voor fotografie
• 🌙 Maanfase berekeningen met Nederlandse namen
• 🌍 Locatie-gebaseerde berekeningen wereldwijd

🎉 Feestdagen & Planning

• 🇳🇱 Complete Nederlandse feestdagen (offline)
• 🌍 Internationale feestdagen voor 100+ landen
• 💼 Werkdagen calculator (exclusief weekends & feestdagen)
• 🔍 Feestdagen vergelijking tussen landen

🧬 Productiviteit & Welzijn

• 🧠 Circadiaans ritme optimalisatie
• ✈️ Jet lag calculator met herstel tips
• 🍅 Pomodoro technique scheduler
• 🌐 International meeting time finder
• ⚡ Bioklok-gebaseerde dagplanning

🛡️ Enterprise Ready

• 🚫 DDoS bescherming en rate limiting
• 📊 Real-time server statistieken
• 🔒 Security best practices
• 🐳 Docker container support
• 📈 Usage analytics en monitoring

🚀 Quick Start

Via Docker (Aanbevolen)

# Pull en run de container
docker run -it ghcr.io/hasecon/mcp-astronomical-time-server:latest

# Of met Docker Compose
curl -O https://raw.githubusercontent.com/hasecon/mcp-astronomical-time-server/main/docker-compose.yml
docker-compose up -d

Handmatige Installatie

# Clone de repository
git clone https://github.com/hasecon/mcp-astronomical-time-server.git
cd mcp-astronomical-time-server

# Installeer dependencies
npm install

# Bouw het project
npm run build

# Start de server
npm start

Claude Desktop Integratie

Voeg dit toe aan je Claude Desktop configuratie:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "astronomical-time": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hasecon/mcp-astronomical-time-server:latest"
      ]
    }
  }
}

Of gecombineerd met andere MCP servers zoals GitHub:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ]
    },
    "astronomical-time": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hasecon/mcp-astronomical-time-server:latest"
      ]
    }
  }
}

📖 Usage Examples

Basis Tijd Functies

"Wat is de huidige tijd in Tokyo?"
→ get_current_time met timezone: "Asia/Tokyo"

"Hoeveel tijd tot Nieuwjaar?"
→ countdown_to_event met target: "2026-01-01T00:00:00Z"

Astronomische Planning

"Wanneer is golden hour vandaag in Amsterdam?"
→ get_golden_hour met coords: 52.3676°N, 4.9041°E

"Complete astronomische info voor New York"
→ get_astronomical_info met NYC coordinates

Internationale Teams

"Beste vergadertijd voor Amsterdam, San Francisco en Tokyo?"
→ find_meeting_time met deze 3 tijdzones

"Vergelijk feestdagen Nederland, Duitsland en Frankrijk"
→ compare_holidays tussen deze landen

Productiviteit

"Optimaal dagschema gebaseerd op zonsopgang Rotterdam?"
→ get_circadian_schedule met Rotterdam coords

"Pomodoro schema vanaf 14:00"
→ create_pomodoro_schedule met start tijd

🛠️ API Reference

🌍 Ondersteunde Landen

De server ondersteunt 100+ landen voor feestdagen via de gratis Nager.Date API:

🇳🇱 Nederland • 🇩🇪 Duitsland • 🇫🇷 Frankrijk • 🇬🇧 VK • 🇺🇸 VS • 🇮🇹 Italië • 🇪🇸 Spanje • 🇧🇪 België • 🇨🇭 Zwitserland • 🇦🇹 Oostenrijk • 🇩🇰 Denemarken • 🇸🇪 Zweden • 🇳🇴 Noorwegen • 🇫🇮 Finland • 🇵🇱 Polen • 🇨🇦 Canada • 🇦🇺 Australië • 🇳🇿 Nieuw-Zeeland • 🇯🇵 Japan • 🇰🇷 Zuid-Korea • 🇨🇳 China • 🇮🇳 India • 🇧🇷 Brazilië • 🇷🇺 Rusland

🐳 Docker Deployment

Development

# Bouw lokaal
docker build -t mcp-time-server .
docker run -it mcp-time-server

Production met Docker Compose

# Download productie configuratie
curl -O https://raw.githubusercontent.com/hasecon/mcp-astronomical-time-server/main/docker-compose.yml

# Start services
docker-compose up -d

# Bekijk logs
docker-compose logs -f mcp-time-server

# Stop services
docker-compose down

🛡️ Security & Rate Limiting

De server bevat ingebouwde bescherming tegen misbruik:

• Rate Limiting: 100 requests per 15 minuten, 20 per minuut
• DDoS Protection: Automatische IP tracking en blocking
• Resource Limits: Memory en CPU beperking
• Security Headers: Veilige HTTP headers
• Container Security: Non-root user, read-only filesystem

📊 Monitoring & Analytics

Server Statistieken

"Hoe draait de server?"
→ get_server_stats

Toont:
📊 Request counts en error rates
⏰ Server uptime
🎯 Populairste tools  
🛡️ Rate limiting status
🌟 Active features

🤝 Contributing

We verwelkomen bijdragen! Zie onze voor details.

Development Setup

# Clone en setup
git clone https://github.com/hasecon/mcp-astronomical-time-server.git
cd mcp-astronomical-time-server
npm install

# Development mode met hot reload
npm run dev

# Run tests
npm test

# Linting en formatting
npm run lint
npm run format

📜 License

Dit project is gelicenseerd onder de .

🙏 Acknowledgments

• Anthropic voor het Model Context Protocol
• Nager.Date voor internationale feestdagen data
• Node.js en TypeScript community

📞 Support

• 📚
• 🐛 Issues
• 💬 Discussions
• 📧 Email: