MCP+Spatial Federation Deployment Guide

pip install -r requirements.txt
# Core dependencies:
# - services/intelligence/spatial/
# - services/integrations/mcp/
# - services/orchestration/

# GitHub Personal Access Token (if required)
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx

# GitHub API rate limiting (default: 5000 req/hour)
GITHUB_RATE_LIMIT=5000

# Notion Integration Token (required)
NOTION_INTEGRATION_TOKEN=secret_xxxxxxxxxxxxxxxxxxxx

# Notion workspace ID
NOTION_WORKSPACE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

# Rate limiting (3 req/sec compliance)
NOTION_RATE_LIMIT=3

# Spatial analysis cache TTL (seconds)
SPATIAL_CACHE_TTL=3600

# Performance targets
SPATIAL_TARGET_FEDERATED_MS=150
SPATIAL_TARGET_CONTEXT_MS=50

# Run Alembic migrations
alembic upgrade head

# Verify spatial intelligence tables
psql -d piper_morgan -c "\dt *spatial*"

# Start core services
python -m services.orchestration.main

# Verify MCP adapters
python -c "
from services.integrations.mcp.github_adapter import GitHubMCPAdapter
from services.integrations.mcp.notion_adapter import NotionMCPAdapter
print('✅ MCP adapters ready')
"

# Test spatial intelligence initialization
python -c "
from services.intelligence.spatial.github_spatial import GitHubSpatialIntelligence
from services.intelligence.spatial.notion_spatial import NotionSpatialIntelligence
print('✅ Spatial intelligence ready')
"

# Run production readiness tests
python -m pytest tests/integration/test_production_readiness.py -v

# Expected results: 90%+ success rate

# Health check
curl http://localhost:8081/health

# Spatial intelligence status
curl http://localhost:8081/api/spatial/status

# MCP adapter status
curl http://localhost:8081/api/mcp/status

# Check spatial intelligence performance
python -c "
import time
from services.intelligence.spatial.notion_spatial import NotionSpatialIntelligence

spatial = NotionSpatialIntelligence()
start = time.time()
spatial.analyze_page_structure('test_page_id')
duration = (time.time() - start) * 1000
print(f'Spatial analysis: {duration:.3f}ms')
"

# Monitor spatial intelligence logs
tail -f logs/spatial_intelligence.log

# Monitor MCP adapter logs
tail -f logs/mcp_adapters.log

# Check dependencies
python -c "import services.intelligence.spatial"

# Verify database connectivity
python -c "from services.database import get_db; print(get_db())"

# Test GitHub connection
python -c "
from services.integrations.mcp.github_adapter import GitHubMCPAdapter
adapter = GitHubMCPAdapter()
print(adapter.test_connection())
"

# Test Notion connection
python -c "
from services.integrations.mcp.notion_adapter import NotionMCPAdapter
adapter = NotionMCPAdapter()
print(adapter.test_connection())
"

# Check cache hit rates
python -c "
from services.cache import get_cache_stats
print(get_cache_stats())
"

# Monitor spatial analysis timing
python -c "
from services.intelligence.spatial.base import BaseSpatialIntelligence
print(BaseSpatialIntelligence.get_performance_metrics())
"

# Disable spatial intelligence
export DISABLE_SPATIAL_INTELLIGENCE=true

# Restart services
pkill -f "services.orchestration.main"
python -m services.orchestration.main

# Disable specific dimensions
export DISABLE_SPATIAL_DIMENSIONS=CAUSAL,CONTEXTUAL

# Restart with reduced functionality
python -m services.orchestration.main