Astral MCP Server
by davidmosiahio.github.davidmosiah/astral-mcpv0.2.0
Astrology tools for natal charts, current transits, synastry, Moon phases and birthplace lookup, with privacy modes for compact payloads.
context tax
queued
security
queued
cold start
queued
freshness
Maintained38d ago
Install Astral MCP server
Install in Claude Code
claude mcp add astral -- npx -y astral-mcpInstall in Cursor
{
"mcpServers": {
"astral": {
"command": "npx",
"args": [
"-y",
"astral-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"astral": {
"command": "npx",
"args": [
"-y",
"astral-mcp"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"astral": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"astral-mcp"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"astral": {
"command": "npx",
"args": [
"-y",
"astral-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ASTRAL_MCP_TRANSPORT | — | — | Transport to run. Defaults to stdio. Set to http to expose a streamable HTTP endpoint instead. |
| ASTRAL_MCP_HOST | — | — | Host to bind when ASTRAL_MCP_TRANSPORT=http. Defaults to 127.0.0.1. |
| ASTRAL_MCP_PORT | — | — | Port to bind when ASTRAL_MCP_TRANSPORT=http. Defaults to 3000. |
| ASTRAL_MCP_ALLOWED_ORIGIN | — | — | Allowed CORS origin for the HTTP transport. Defaults to the bound host:port. |
Freshness
Maintained — last maintenance signal 38d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-01 · 38d ago · GitHub
Latest release
2026-08-29 · 41d ago · GitHub · v0.3.2
Package published
no data · npm/PyPI
Registry entry updated
2026-06-07 · 4mo ago · official registry · v0.2.0
FAQ
›How do I install the Astral MCP server in Claude Code?
Run: claude mcp add astral -- npx -y astral-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Astral require an API key?
No required environment variables are declared in its published metadata.
›Can I use Astral as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Astral in the official MCP registry?
Yes, as io.github.davidmosiah/astral-mcp.