feature: work on publishing, rename repo

add makefile target to validate public docker image
Add some more sanity checking and validation for docker, details about mcp in general
rename project to ephemeris-mcp

Author: scottchronicity

.cursorrules

@@ -1,4 +1,4 @@
-# Cursor Rules for AstroMCP
+# Cursor Rules for EphemerisMCP
 
 ## Stack
 - Python 3.11 (strict)

.github/FUNDING.yml

@@ -1,7 +1,7 @@
-# Funding options for AstroMCP
+# Funding options for EphemerisMCP
 # Uncomment and configure as needed:
 github: [scottchronicity]
 patreon: scottchronicity
-# open_collective: astro-mcp
+# open_collective: ephemeris-mcp
 # ko_fi: username
 # custom: ['https://your-link.com']

.github/ISSUE_TEMPLATE/bug_report.md

@@ -23,7 +23,7 @@ What actually happened.
 ## Environment
 - OS: 
 - Python version: 
-- astro-mcp version: 
+- ephemeris-mcp version: 
 
 ## Additional Context
 Any other relevant information.

.github/copilot-instructions.md

@@ -1,7 +1,7 @@
-# GitHub Copilot Instructions for AstroMCP
+# GitHub Copilot Instructions for Ephemeris MCP
 
 ## What This Project Does
-AstroMCP is an MCP (Model Context Protocol) server that calculates planetary positions using the Swiss Ephemeris. It provides AI agents with ground-truth astrological data in Tropical Zodiac coordinates.
+Ephemeris MCP is an MCP (Model Context Protocol) server that calculates planetary positions using the Swiss Ephemeris. It provides AI agents with precision astronomical ephemeris data in Tropical Zodiac coordinates.
 
 ## Architecture
 - `server.py`: FastMCP server exposing `get_planetary_positions` tool

.github/workflows/cd-release.yml

@@ -62,3 +62,31 @@ jobs:
           tags: |
             ghcr.io/${{ github.repository }}:v${{ needs.release.outputs.version }}
             ghcr.io/${{ github.repository }}:latest
+
+  pypi:
+    needs: release
+    if: needs.release.outputs.released == 'true'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/ephemeris-mcp
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: v${{ needs.release.outputs.version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.vscode/launch.json

@@ -8,7 +8,7 @@
       "name": "Debug MCP Server",
       "type": "debugpy",
       "request": "launch",
-      "module": "astro_mcp.server",
+      "module": "ephemeris_mcp.server",
       "console": "integratedTerminal",
       "justMyCode": false,
       "env": {

AGENTS.md

@@ -4,14 +4,14 @@
 
 ## Project Overview
 
-AstroMCP is a Model Context Protocol (MCP) server providing precision astrological calculations via the Swiss Ephemeris.
+Ephemeris MCP is a Model Context Protocol (MCP) server providing precision astronomical ephemeris calculations via the Swiss Ephemeris.
 
 ## Codebase Map
 
 | Path | Purpose |
 |------|---------|
-| `src/astro_mcp/server.py` | MCP server interface (FastMCP) |
-| `src/astro_mcp/engine.py` | Physics calculation engine (Flatlib/Swiss Ephemeris) |
+| `src/ephemeris_mcp/server.py` | MCP server interface (FastMCP) |
+| `src/ephemeris_mcp/engine.py` | Physics calculation engine (Flatlib/Swiss Ephemeris) |
 | `tests/test_engine.py` | Unit tests for calculation engine |
 | `docs/adr/` | Architecture Decision Records |
 

CONTRIBUTING.md

@@ -1,11 +1,11 @@
-# Contributing to AstroMCP
+# Contributing to EphemerisMCP
 
 Thank you for your interest in contributing!
 
 ## Getting Started
 
 1. Fork the repository
-2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/astro-mcp.git`
+2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/ephemeris-mcp.git`
 3. Install dependencies: `make install`
 4. Create a branch: `git checkout -b feat/your-feature`
 

Dockerfile

@@ -36,4 +36,4 @@ ENV PATH="/app/.venv/bin:$PATH"
 ENV PYTHONPATH="/app/src"
 
 # Run the MCP server
-CMD ["python", "-m", "astro_mcp.server"]
+CMD ["python", "-m", "ephemeris_mcp.server"]

Makefile

@@ -1,17 +1,17 @@
-# Makefile for AstroMCP
+# Makefile for EphemerisMCP
 
 # Variables
-IMAGE_NAME := astro-mcp
+IMAGE_NAME := ephemeris-mcp
 VERSION := 0.1.0
 PYTHON_VERSION := 3.11
 
-.PHONY: all help install format lint test build clean docker-build docker-run act
+.PHONY: all help install format lint test build clean docker-build docker-run docker-happycase-public docker-happycase-mcp act
 
 all: install format lint test
 
 help:
-	@echo "AstroMCP Development Commands"
-	@echo "============================="
+	@echo "Ephemeris MCP Development Commands"
+	@echo "==================================="
 	@echo "make install      - Sync dependencies (uses Python $(PYTHON_VERSION))"
 	@echo "make format       - Format code using Ruff"
 	@echo "make format-check - Check code formatting without modifying"
@@ -22,6 +22,8 @@ help:
 	@echo "make docker-build     - Build the Docker image"
 	@echo "make docker-run       - Run the Docker container interactively"
 	@echo "make docker-happycase - Test the Docker image with a simple query"
+	@echo "make docker-happycase-public - Test the public GHCR image with a simple query"
+	@echo "make docker-happycase-mcp - Test the MCP server interface (agent-style)"
 	@echo "make docker-dev       - Full Docker dev workflow (validate, build, test)"
 	@echo "make docker-clean     - Remove Docker images"
 	@echo "make validate-happycase - Test engine locally with a simple query"
@@ -30,6 +32,13 @@ help:
 	@echo "make audit        - Audit dependencies"
 	@echo "make act-ci       - Run CI workflow locally with act"
 	@echo "make act-release  - Run Release workflow locally with act (dry-run)"
+	@echo ""
+	@echo "PyPI Publishing:"
+	@echo "make build        - Build distribution packages (wheel + sdist)"
+	@echo "make test-pypi-local - Test local build installation"
+	@echo "make validate-happycase-pypi - Test PyPI installed version"
+	@echo "make publish-test - Publish to TestPyPI (requires API token)"
+	@echo "make publish      - Publish to PyPI (requires API token)"
 
 # --- Development ---
 
@@ -39,7 +48,7 @@ lock:
 
 sync: lock
 	@echo "📦 Syncing dependencies with Python $(PYTHON_VERSION)..."
-	uv sync --python $(PYTHON_VERSION)
+	uv sync --all-groups --python $(PYTHON_VERSION)
 
 install: sync
 	@echo "✅ Dependencies installed."
@@ -71,7 +80,7 @@ validate-dev:
 validate-happycase:
 	@echo "🧪 Testing engine locally with planetary positions query..."
 	@echo "📍 Querying: 2025-12-16T15:28:00Z at New York (40.7128, -74.0060)"
-	@uv run python -c "from astro_mcp.engine import calculate_chart; result = calculate_chart('2025-12-16T15:28:00Z', 40.7128, -74.0060); print('✅ Engine working!\n'); print('🌟 BODIES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}° ({data[\"motion\"]})') for name, data in result['bodies'].items()]; print('\n🏠 HOUSES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}°') for name, data in result['houses'].items()]"
+	@uv run python -c "from ephemeris_mcp.engine import calculate_chart; result = calculate_chart('2025-12-16T15:28:00Z', 40.7128, -74.0060); print('✅ Engine working!\n'); print('🌟 BODIES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}° ({data[\"motion\"]})') for name, data in result['bodies'].items()]; print('\n🏠 HOUSES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}°') for name, data in result['houses'].items()]"
 	@echo "\n✅ Happy case test passed!"
 
 validate-dev-full: validate-dev
@@ -104,9 +113,21 @@ docker-run:
 docker-happycase:
 	@echo "🧪 Testing Docker image with planetary positions query..."
 	@echo "📍 Querying: 2025-12-16T15:28:00Z at New York (40.7128, -74.0060)"
-	@docker run --rm $(IMAGE_NAME):latest python -c "from astro_mcp.engine import calculate_chart; import json; result = calculate_chart('2025-12-16T15:28:00Z', 40.7128, -74.0060); print('✅ Docker image working!\n'); print('🌟 BODIES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}° ({data[\"motion\"]})') for name, data in result['bodies'].items()]; print('\n🏠 HOUSES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}°') for name, data in result['houses'].items()]"
+	@docker run --rm $(IMAGE_NAME):latest python -c "from ephemeris_mcp.engine import calculate_chart; import json; result = calculate_chart('2025-12-16T15:28:00Z', 40.7128, -74.0060); print('✅ Docker image working!\n'); print('🌟 BODIES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}° ({data[\"motion\"]})') for name, data in result['bodies'].items()]; print('\n🏠 HOUSES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}°') for name, data in result['houses'].items()]"
 	@echo "\n✅ Docker test passed!"
 
+docker-happycase-public:
+	@echo "🧪 Testing public GHCR image with planetary positions query..."
+	@echo "📦 Pulling ghcr.io/scottchronicity/ephemeris-mcp:latest..."
+	@docker pull ghcr.io/scottchronicity/ephemeris-mcp:latest
+	@echo "📍 Querying: 2025-12-16T15:28:00Z at New York (40.7128, -74.0060)"
+	@docker run --rm ghcr.io/scottchronicity/ephemeris-mcp:latest python -c "from ephemeris_mcp.engine import calculate_chart; import json; result = calculate_chart('2025-12-16T15:28:00Z', 40.7128, -74.0060); print('✅ Public image working!\n'); print('🌟 BODIES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}° ({data[\"motion\"]})') for name, data in result['bodies'].items()]; print('\n🏠 HOUSES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}°') for name, data in result['houses'].items()]"
+	@echo "\n✅ Public image test passed!"
+
+docker-happycase-mcp:
+	@echo "🧪 Testing MCP server interface (agent-style)..."
+	@python3 test_mcp_client.py
+
 docker-dev: validate-dev docker-build docker-happycase
 	@echo "✅ Full Docker dev workflow complete!"
 	@echo "📦 Image ready: $(IMAGE_NAME):$(VERSION)"
@@ -138,4 +159,56 @@ act-ci:
 
 act-release:
 	@echo "🎬 Running Release workflow locally with act (dry-run)..."
-	act push --container-architecture linux/amd64 -W .github/workflows/cd-release.yml --dryrun
+	act push --container-architecture linux/amd64 -W .github/workflows/cd-release.yml --dryrun
+# --- PyPI Publishing ---
+
+build:
+	@echo "📦 Building distribution packages..."
+	uv build
+	@echo "✅ Build complete! Check dist/ directory"
+	@ls -lh dist/
+
+test-pypi-local:
+	@echo "🧪 Testing local build installation..."
+	@echo "Creating fresh virtual environment for testing..."
+	@rm -rf /tmp/ephemeris-mcp-test-env
+	@uv venv /tmp/ephemeris-mcp-test-env
+	@echo "Installing from local build..."
+	@uv pip install --python /tmp/ephemeris-mcp-test-env dist/*.whl
+	@echo "Testing import..."
+	@/tmp/ephemeris-mcp-test-env/bin/python -c "from ephemeris_mcp.engine import calculate_chart; print('✅ Import successful')"
+	@echo "Testing entry point exists..."
+	@test -f /tmp/ephemeris-mcp-test-env/bin/ephemeris-mcp && echo "✅ CLI entry point installed" || echo "❌ Entry point missing"
+	@echo "Testing engine with sample query..."
+	@/tmp/ephemeris-mcp-test-env/bin/python -c "from ephemeris_mcp.engine import calculate_chart; result = calculate_chart('2025-12-16T15:28:00Z', 40.7128, -74.0060); print(f'✅ Engine working! Sun in {result[\"bodies\"][\"Sun\"][\"sign\"]}')"
+	@echo "✅ Local build test passed!"
+	@rm -rf /tmp/ephemeris-mcp-test-env
+
+validate-happycase-pypi:
+	@echo "🧪 Testing PyPI installed version..."
+	@echo "Creating fresh virtual environment..."
+	@rm -rf /tmp/ephemeris-mcp-pypi-test
+	@uv venv /tmp/ephemeris-mcp-pypi-test
+	@echo "Installing from PyPI..."
+	@uv pip install --python /tmp/ephemeris-mcp-pypi-test ephemeris-mcp
+	@echo "📍 Querying: 2025-12-16T15:28:00Z at New York (40.7128, -74.0060)"
+	@/tmp/ephemeris-mcp-pypi-test/bin/python -c "from ephemeris_mcp.engine import calculate_chart; result = calculate_chart('2025-12-16T15:28:00Z', 40.7128, -74.0060); print('✅ PyPI version working!\n'); print('🌟 BODIES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}° ({data[\"motion\"]})') for name, data in result['bodies'].items()]; print('\n🏠 HOUSES:'); [print(f'  {name:18} {data[\"sign\"]:10} {data[\"sign_degrees\"]:6.2f}°') for name, data in result['houses'].items()]"
+	@echo "\n✅ PyPI happy case test passed!"
+	@rm -rf /tmp/ephemeris-mcp-pypi-test
+
+publish-test:
+	@echo "🚀 Publishing to TestPyPI..."
+	@echo "⚠️  Requires TWINE_PASSWORD env var with TestPyPI token"
+	@uv build
+	@uv run twine upload --repository testpypi dist/* --username __token__
+
+publish:
+	@echo "🚀 Publishing to PyPI..."
+	@echo "⚠️  Requires TWINE_PASSWORD env var with PyPI token"
+	@echo "⚠️  This will publish to production PyPI!"
+	@read -p "Are you sure? [y/N] " -n 1 -r; echo; \
+	if [[ $$REPLY =~ ^[Yy]$$ ]]; then \
+		uv build && uv run twine upload dist/* --username __token__; \
+	else \
+		echo "Cancelled."; \
+	fi