Offline observational astronomy — planet and moon positions, rise/set, phases, eclipses, and seasons for any place and time via MCP. STDIO or Streamable HTTP.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add astronomy -- npx -y @cyanheads/astronomy-mcp-server~/.codex/config.toml
[mcp_servers.astronomy]
command = "npx"
args = ["-y", "@cyanheads/astronomy-mcp-server"]
# codex mcp add astronomy -- npx -y @cyanheads/astronomy-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"astronomy": {
"command": "npx",
"args": [
"-y",
"@cyanheads/astronomy-mcp-server"
]
}
}
}.vscode/mcp.json
{
"servers": {
"astronomy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/astronomy-mcp-server"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"astronomy": {
"command": "npx",
"args": [
"-y",
"@cyanheads/astronomy-mcp-server"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"astronomy": {
"command": "npx",
"args": [
"-y",
"@cyanheads/astronomy-mcp-server"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"astronomy": {
"command": "npx",
"args": [
"-y",
"@cyanheads/astronomy-mcp-server"
]
}
}
}Remote
claude mcp add --transport http astronomy https://astronomy.caseyjhand.com/mcp~/.codex/config.toml
[mcp_servers.astronomy]
url = "https://astronomy.caseyjhand.com/mcp"
# codex mcp add astronomy --url https://astronomy.caseyjhand.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"astronomy": {
"url": "https://astronomy.caseyjhand.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"astronomy": {
"type": "http",
"url": "https://astronomy.caseyjhand.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"astronomy": {
"httpUrl": "https://astronomy.caseyjhand.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"astronomy": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://astronomy.caseyjhand.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"astronomy": {
"url": "https://astronomy.caseyjhand.com/mcp"
}
}
}