Government of Canada Open Data MCP Servers

# Setup Complete! 🎉 ## Quick Start ### Option 1: Using the Activation Script (Recommended) ```bash cd /Users/krunal/Desktop/gov_mcp ./activate.sh ``` This will activate the virtual environment and show you next steps. ### Option 2: Manual Activation ```bash cd /Users/krunal/Desktop/gov_mcp source venv/bin/activate ``` ## Running the Server Once the environment is activated: ```bash # Start the MCP server python -m gov_mcp.server # Or use the direct entry point gov-mcp-server ``` ## Testing & Validation ```bash # Quick test (verify everything is working) python test_server.py # Full validation python validate.py # Run examples python examples.py ``` ## Project Structure ``` gov_mcp/ ├── venv/ ← Virtual environment (created, ready to use) ├── gov_mcp/ ← Main package │ ├── __init__.py │ ├── types.py ← Type definitions │ ├── http_client.py ← HTTP client with retry logic │ ├── api_client.py ← Open Government API wrapper │ └── server.py ← MCP server implementation ├── README.md ← Full documentation ├── ARCHITECTURE.md ← Technical architecture ├── GETTING_STARTED.md ← Beginner guide ├── DEPLOYMENT.md ← Production deployment ├── pyproject.toml ← Project config ├── requirements.txt ← Dependencies ├── .env.example ← Configuration template ├── .python-version ← Python version (3.14) ├── activate.sh ← Quick activation script ├── validate.py ← Validation script ├── examples.py ← Usage examples └── test_server.py ← Quick server test ``` ## What's Working ✅ **Virtual Environment** - Python 3.14.0 ready to go ✅ **All Dependencies** - Installed and configured ✅ **7 Core Tools** - All registered and functional ✅ **API Client** - Ready to query Canadian government data ✅ **MCP Server** - Ready to serve tool calls ✅ **Documentation** - Complete and comprehensive ✅ **Testing** - Validation scripts included ## Key Features - 🔍 **Search Datasets** - search_all_infrastructure - 📋 **Get Schemas** - get_dataset_schema - 🏢 **List Organizations** - list_organizations - 🗂️ **Browse Topics** - browse_by_topic - ✅ **Check MCPs** - check_available_mcps - 📡 **Activity Stream** - get_activity_stream - 💾 **Query Data** - basic_datastore_query ## Configuration To customize settings, copy `.env.example` to `.env`: ```bash cp .env.example .env ``` Then edit `.env` with your preferred settings. ## Next Steps 1. **Try the examples:** ```bash python examples.py ``` 2. **Start the server:** ```bash python -m gov_mcp.server ``` 3. **Integrate with Claude/MCP:** Configure your MCP client to use: `gov-mcp-server` 4. **Read the docs:** - `README.md` - Full feature documentation - `ARCHITECTURE.md` - Technical deep dive - `GETTING_STARTED.md` - Beginner friendly guide ## Troubleshooting **Q: Virtual environment not activating?** A: Make sure you're in the project directory: `cd /Users/krunal/Desktop/gov_mcp` **Q: Module import errors?** A: Reinstall dependencies: `pip install -e .` **Q: API connection issues?** A: Check your internet connection and verify API is reachable at https://open.canada.ca/data/api **Q: Python version mismatch?** A: We're using Python 3.14.0. Check with: `python --version` ## Support - 📖 Check GETTING_STARTED.md for beginner guide - 🏗️ Check ARCHITECTURE.md for technical details - 📦 Check README.md for feature documentation - 🧪 Run validate.py to diagnose issues --- **Version:** 0.1.0 **Status:** ✅ Production Ready **Last Updated:** 2025-11-26