maeris 1.0.0__tar.gz

maeris-1.0.0/.dockerignore

@@ -0,0 +1,27 @@
+# Binaries
+bin/
+*.exe
+*.dll
+*.so
+*.dylib
+
+# Test files
+*_test.go
+
+# IDE/Editor
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Git
+.git/
+.gitignore
+
+# Documentation
+LICENSE
+
+# OS files
+.DS_Store
+Thumbs.db
+*.md

maeris-1.0.0/.env.example

@@ -0,0 +1,43 @@
+# Maeris MCP Server - Environment Variables
+# Copy this file to .env and fill in your values.
+
+# =============================================================================
+# FRONTEND & BACKEND URLs
+# =============================================================================
+
+# Maeris App (Frontend) - Where the browser opens for authentication.
+# The app must implement two routes used by `maeris-mcp login`:
+#   GET /auth/login        - initiates Firebase auth (receives client_id, redirect_uri, state)
+#   GET /auth/callback     - receives Firebase redirect, stores token keyed by state
+#   GET /api/auth/poll     - polled by MCP; returns { token, token_type, ready } or { error } or 404 while pending
+# Dev: http://localhost:3000
+# Prod: https://app.maeris.com (or your production frontend URL)
+
+MAERIS_APP_URL=http://localhost:3000
+
+# Maeris API (Backend) - Where API calls are made
+# Dev: http://localhost:5000 (or your backend dev port)
+# Prod: https://mirabilis-dev.up.railway.app
+
+MAERIS_API_URL=http://localhost:5000
+
+# =============================================================================
+# SERVER CONFIGURATION
+# =============================================================================
+
+# HTTP port (Railway sets this automatically, no need to configure)
+# PORT=8080
+
+# Log level for server output (DEBUG, INFO, WARNING, ERROR)
+MAERIS_LOG_LEVEL=DEBUG
+
+# =============================================================================
+# API ENDPOINTS
+# =============================================================================
+
+# Security scan API paths (override if your backend differs)
+MAERIS_SECURITY_SCAN_PATH=/security/scans
+MAERIS_SECURITY_FINDINGS_PATH=/security/findings
+
+# Directory for storing security scan reports (optional, defaults to ./security-reports)
+# MAERIS_REPORTS_DIR=/path/to/custom/reports/directory

maeris-1.0.0/.gitignore

@@ -0,0 +1,95 @@
+# Binaries
+bin/
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary
+*.test
+
+# Output of the go coverage tool
+*.out
+
+# Go workspace file
+go.work
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+.venv/
+ENV/
+env/
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# pyenv
+.python-version
+security-reports/
+
+# Environment variables
+.env
+*.__pycache__

maeris-1.0.0/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "maeris-mcp": {
+      "type": "streamable-http",
+      "url": "https://maeris-mcp-dev.up.railway.app/mcp/"
+    }
+  }
+}

maeris-1.0.0/Dockerfile

@@ -0,0 +1,33 @@
+# Build stage
+FROM python:3.11-slim AS builder
+
+WORKDIR /app
+
+# Install uv
+RUN pip install uv
+
+# Copy project files
+COPY pyproject.toml ./
+COPY src ./src
+
+# Install the package (non-editable)
+RUN uv pip install --system .
+
+# Runtime stage
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Copy installed packages and source
+COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
+COPY --from=builder /app/src ./src
+
+# Railway and Cloud Run both set PORT automatically, default to 8080
+ENV PORT=8080
+ENV PYTHONPATH=/app/src
+
+# Expose the port
+EXPOSE 8080
+
+# Run in HTTP mode, using PORT env variable
+CMD ["sh", "-c", "python -m maeris_mcp --mode=http --port=${PORT}"]

maeris-1.0.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: maeris
+Version: 1.0.0
+Summary: MCP server for extracting, analyzing, and documenting React/frontend APIs
+Author-email: Anant Mathur <anant.mathur@autoelight.com>
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2.0.0,>=1.0.0
+Requires-Dist: pydantic<3.0,>=2.5
+Requires-Dist: pyjwt>=2.8
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: starlette>=0.36
+Requires-Dist: structlog>=24.1
+Requires-Dist: uvicorn>=0.27
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.2; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Maeris
+
+Security and API scanning for your codebase, powered by Claude.
+
+Maeris is an MCP (Model Context Protocol) server that gives Claude the ability to scan your code for security vulnerabilities, extract API definitions, and push results to the [Maeris Portal](https://autoe-light-dev.up.railway.app).
+
+## Quick Start
+
+**1. Install**
+```bash
+pip install maeris
+```
+
+**2. Register the MCP server for your project** (run from your project root)
+```bash
+maeris init
+```
+
+**3. Restart Claude Code**
+
+That's it. Claude can now scan your codebase for security vulnerabilities and API calls.
+
+## Authentication
+
+Some features (like pushing scan results to the Maeris Portal) require an account.
+
+```bash
+maeris login
+```
+
+This opens your browser to authenticate. Credentials are stored per-project so each repo is fully isolated.
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `maeris init` | Register the MCP server for the current repository |
+| `maeris login` | Authenticate with Maeris Portal |
+| `maeris logout` | Sign out and remove stored credentials |
+| `maeris status` | Show current authentication status |
+| `maeris switch-app` | Switch the active application |
+
+## What Claude Can Do
+
+Once the MCP server is running, ask Claude to:
+
+- **Scan for vulnerabilities** — `"Scan this codebase for security issues"`
+- **Extract APIs** — `"Extract all API calls from the src/ folder"`
+- **Push to Maeris** — `"Push the scan results to Maeris"`
+
+## Requirements
+
+- Python 3.11+
+- [Claude Code](https://claude.ai/code)
+
+## License
+
+MIT

maeris-1.0.0/README.md

@@ -0,0 +1,58 @@
+# Maeris
+
+Security and API scanning for your codebase, powered by Claude.
+
+Maeris is an MCP (Model Context Protocol) server that gives Claude the ability to scan your code for security vulnerabilities, extract API definitions, and push results to the [Maeris Portal](https://autoe-light-dev.up.railway.app).
+
+## Quick Start
+
+**1. Install**
+```bash
+pip install maeris
+```
+
+**2. Register the MCP server for your project** (run from your project root)
+```bash
+maeris init
+```
+
+**3. Restart Claude Code**
+
+That's it. Claude can now scan your codebase for security vulnerabilities and API calls.
+
+## Authentication
+
+Some features (like pushing scan results to the Maeris Portal) require an account.
+
+```bash
+maeris login
+```
+
+This opens your browser to authenticate. Credentials are stored per-project so each repo is fully isolated.
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `maeris init` | Register the MCP server for the current repository |
+| `maeris login` | Authenticate with Maeris Portal |
+| `maeris logout` | Sign out and remove stored credentials |
+| `maeris status` | Show current authentication status |
+| `maeris switch-app` | Switch the active application |
+
+## What Claude Can Do
+
+Once the MCP server is running, ask Claude to:
+
+- **Scan for vulnerabilities** — `"Scan this codebase for security issues"`
+- **Extract APIs** — `"Extract all API calls from the src/ folder"`
+- **Push to Maeris** — `"Push the scan results to Maeris"`
+
+## Requirements
+
+- Python 3.11+
+- [Claude Code](https://claude.ai/code)
+
+## License
+
+MIT

maeris-1.0.0/deploy.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+set -e
+
+# Configuration - update these values
+PROJECT_ID="future-lane-478716-f2"
+REGION="us-central1"
+SERVICE_NAME="maeris-mcp"
+IMAGE_NAME="gcr.io/${PROJECT_ID}/${SERVICE_NAME}"
+
+echo "==> Deploying ${SERVICE_NAME} to Cloud Run"
+echo "    Project: ${PROJECT_ID}"
+echo "    Region:  ${REGION}"
+
+# Build the container image
+echo "==> Building container image..."
+podman build -t ${IMAGE_NAME} .
+
+# Push to Google Container Registry
+echo "==> Pushing to GCR..."
+podman push ${IMAGE_NAME}
+
+# Deploy to Cloud Run
+echo "==> Deploying to Cloud Run..."
+gcloud run deploy ${SERVICE_NAME} \
+  --image ${IMAGE_NAME} \
+  --platform managed \
+  --region ${REGION} \
+  --project ${PROJECT_ID} \
+  --allow-unauthenticated \
+  --port 8080
+
+echo "==> Deployment complete!"
+gcloud run services describe ${SERVICE_NAME} --region ${REGION} --project ${PROJECT_ID} --format='value(status.url)'