backplane-mcp 0.1.0__tar.gz

backplane_mcp-0.1.0/.gitignore

@@ -0,0 +1,102 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.serena/
+
+
+# Node
+node_modules/
+.pnpm-store/
+
+# Build output
+frontend/dist/
+
+# Environment
+.env
+.env.local
+.env.*.local
+mcp-server/envs/prod.env
+mcp-server/envs/*.local.env
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+postgres-data/
+
+# Runner runtime artifacts
+runner/logs/
+runner/bin/
+# Top-level runner binary (the launch command runs ./bin/backplane-runner)
+/bin/
+
+# Local file storage (dev fallback for GCS)
+backend/data/
+
+# Alembic
+backend/alembic/versions/__pycache__/
+
+# GCP service account keys
+**/gcp-sa-key.json
+*.key.json
+
+# TypeScript build info
+*.tsbuildinfo
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Runner working state
+runner/bin/
+runner/repos/
+runner/repos-*/
+
+# Runner run-configs carry live API keys and client-shaped settings — never
+# track them. Only the reference variants (*.example.* and *.docker.*, which use
+# ${VALARIS_API_KEY} placeholders) are committed. This is a pattern deny (not a
+# per-file allowlist) so a new client config can never slip in tracked.
+# Session-1 secrets containment, docs/opensource-consolidation-plan.md.
+runner/configs/*.yaml
+runner/configs/*.yml
+runner/configs/*.json
+runner/configs/poc-*
+!runner/configs/*.example.yaml
+!runner/configs/*.example.yml
+!runner/configs/*.example.json
+!runner/configs/*.docker.yaml
+!runner/configs/*.docker.yml
+!runner/configs/*.docker.json
+
+# Local MCP config carries the LIVE prod API key — never track it.
+# (Committed history only ever held a clean localhost stub; this keeps it that way.)
+.mcp.json
+
+# Claude Code per-user session state (agents/hooks/rules/skills remain tracked)
+.claude/projects/
+.claude/scheduled_tasks.lock
+.claude/worktrees/
+
+# Valaris visual-testing run artifacts
+.valaris/
+
+# Local dev compose override (host port remap)
+docker-compose.localdev.yml
+docker-compose.override.yml

backplane_mcp-0.1.0/CLAUDE.md

@@ -0,0 +1,23 @@
+# MCP Server — Quick Reference
+
+```bash
+# Run
+uv run valaris-mcp
+
+# Test
+uv run --extra dev pytest tests/ -v
+
+# Lint
+ruff check src/
+ruff format src/
+```
+
+## Adding a New Tool
+
+1. Create or extend a module in `src/valaris_mcp/tools/`.
+2. Decorate with `@mcp.tool()`, then `@handle_api_errors` below it.
+3. Last parameter: `ctx: Context = None`.
+4. Return `json.dumps(result, indent=2, default=str)`.
+5. Include `_hint` field in response for agentic guidance.
+6. Register the module import in `server.py`.
+7. Add tests in `tests/test_tools.py`.