statuspro-mcp-server 0.1.0__tar.gz

statuspro_mcp_server-0.1.0/.claude-desktop-config.example.json

@@ -0,0 +1,20 @@
+{
+  "mcpServers": {
+    "statuspro-erp-dev": {
+      "command": "/Users/YOUR_USERNAME/.local/bin/uv",
+      "args": ["run", "mcp-hmr", "src/statuspro_mcp/server.py:mcp"],
+      "cwd": "/REPLACE/WITH/YOUR/PATH/TO/statuspro-openapi-client/statuspro_mcp_server",
+      "env": {
+        "STATUSPRO_API_KEY": "${STATUSPRO_API_KEY}",
+        "STATUSPRO_BASE_URL": "https://app.orderstatuspro.com/api/v1"
+      }
+    },
+    "statuspro-erp": {
+      "command": "statuspro-mcp-server",
+      "env": {
+        "STATUSPRO_API_KEY": "${STATUSPRO_API_KEY}",
+        "STATUSPRO_BASE_URL": "https://app.orderstatuspro.com/api/v1"
+      }
+    }
+  }
+}

statuspro_mcp_server-0.1.0/.dockerignore

@@ -0,0 +1,40 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Virtual environments
+venv/
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Git
+.git/
+.gitignore
+
+# Documentation (not needed in container)
+docs/
+*.md
+!README.md
+
+# Deployment files
+DEPLOYMENT.md

statuspro_mcp_server-0.1.0/.env.example

@@ -0,0 +1,26 @@
+# StatusPro MCP Server Configuration
+# Copy to .env and fill in your values, or set in your environment.
+
+# Required: Your StatusPro API key (from StatusPro account settings)
+STATUSPRO_API_KEY=your-api-key-here
+
+# Optional: Override the StatusPro API base URL
+# STATUSPRO_BASE_URL=https://app.orderstatuspro.com/api/v1
+
+# Optional: Override the MCP server port (default: 8765)
+# MCP_PORT=8765
+
+# --- Authentication (for HTTP transport) ---
+# Without auth, the MCP endpoint is open to anyone with the URL.
+# Choose ONE of the options below.
+
+# Option 1: Bearer token (simple, for dev/personal use)
+# Set a secret token — clients must send "Authorization: Bearer <token>"
+# MCP_AUTH_TOKEN=your-secret-token-here
+
+# Option 2: GitHub OAuth (production)
+# Create a GitHub OAuth App: https://github.com/settings/developers
+# Set the callback URL to: <your-base-url>/auth/callback
+# MCP_GITHUB_CLIENT_ID=your-github-client-id
+# MCP_GITHUB_CLIENT_SECRET=your-github-client-secret
+# MCP_BASE_URL=https://your-public-url.ngrok-free.app

statuspro_mcp_server-0.1.0/.gitignore

@@ -0,0 +1,179 @@
+# This file is used to specify files and directories that should be ignored by Git.
+# It is a common practice to include this file in the root of a repository.
+# For more information, see https://git-scm.com/docs/gitignore
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+venv/
+.venv/
+.python-version
+.pytest_cache
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# MkDocs documentation
+site/
+docs/_build/
+docs/autoapi/
+docs/*.log
+docs/all_warnings.txt
+docs/full_build_output.txt
+
+# PyBuilder
+target/
+
+#Ipython Notebook
+.ipynb_checkpoints
+
+# dotenv
+.env
+.env.*
+!.env.example
+
+# Logs directory
+logs/
+
+# IDE and Editor files
+.vscode/
+.idea/
+.cursor/.mcp.json
+*.swp
+*.swo
+*~
+.claude/settings.local.json
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+
+# MyPy type checker
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Security and secrets
+*.key
+*.pem
+*.p12
+secrets/
+credentials/
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+*.bak
+*.backup
+
+# Build artifacts from Poetry packaging
+build/
+dist/
+*.tar.gz
+*.whl
+
+# SARIF security scan results
+*.sarif
+
+# Local development and debug files
+debug_*.py
+demo_*.py
+enhanced_client_example.py
+enhanced_client_v2*.py
+simple_test_client.py
+test_client.py
+test_defaults.py
+test_lint_integration.py
+test_pagination*.py
+test_poetry_client.py
+debug_pagination.py
+debug_products.py
+demo_transport.py
+quick_test_*.py
+
+# Keep important test files (in tests/ directory)
+!tests/
+
+# Generated API documentation
+api_docs/
+openapi_docs/
+
+# Backup files
+*.orig
+*.rej
+
+# Coverage and analysis files
+coverage.json
+api_analysis_results.json
+validation_results.json
+
+# Generated MCP metadata
+tools.json
+
+# Claude
+.claude/settings.local.json
+
+# Node.js / TypeScript packages
+node_modules/
+*.tsbuildinfo

statuspro_mcp_server-0.1.0/CHANGELOG.md

@@ -0,0 +1,5 @@
+# CHANGELOG
+
+All notable changes to the StatusPro MCP Server will be documented in this file.
+
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

statuspro_mcp_server-0.1.0/Dockerfile

@@ -0,0 +1,46 @@
+# StatusPro MCP Server Docker Image
+# Provides an isolated, secure environment for running the StatusPro Manufacturing ERP MCP server
+# Compatible with Docker MCP Catalog and Toolkit
+#
+# Supports multiple transport modes via MCP_TRANSPORT env var:
+#   - streamable-http (default): HTTP transport for Claude.ai co-work and remote clients
+#   - stdio: Standard I/O for Claude Desktop and Claude Code
+#   - sse: Server-Sent Events for Cursor IDE
+
+FROM python:3.14-slim
+
+# Metadata
+LABEL org.opencontainers.image.title="StatusPro MCP Server"
+LABEL org.opencontainers.image.description="Model Context Protocol server for StatusPro Manufacturing ERP"
+LABEL org.opencontainers.image.version="0.1.0"
+LABEL org.opencontainers.image.vendor="Doug Borg"
+LABEL org.opencontainers.image.source="https://github.com/dougborg/statuspro-openapi-client"
+LABEL org.opencontainers.image.licenses="MIT"
+
+# Set working directory
+WORKDIR /app
+
+# Install uv for fast dependency installation
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+# Copy dependency files and source code
+COPY pyproject.toml /app/
+COPY src/ /app/src/
+COPY README.md /app/
+
+# Install package (--no-sources skips workspace reference, resolves from PyPI)
+RUN uv pip install --system --no-cache --no-sources .
+
+# Create non-root user for security
+RUN useradd -m -u 1000 mcp && \
+    chown -R mcp:mcp /app
+USER mcp
+
+# Environment variables (can be overridden at runtime)
+ENV STATUSPRO_BASE_URL="https://app.orderstatuspro.com/api/v1"
+# Expose HTTP port (used by streamable-http, http, and sse transports)
+EXPOSE 8765
+
+# Run the MCP server with configurable transport
+ENTRYPOINT ["python", "-m", "statuspro_mcp"]
+CMD ["--transport", "streamable-http", "--host", "0.0.0.0", "--port", "8765"]

statuspro_mcp_server-0.1.0/MCP_CURSOR_SETUP.md

@@ -0,0 +1,177 @@
+# StatusPro MCP Server - Cursor IDE Setup
+
+This guide explains how to run the StatusPro MCP server independently and connect Cursor
+IDE to it via SSE transport. For Claude.ai co-work or other HTTP clients, see the
+[Docker guide](docs/docker.md) or the [README](README.md).
+
+## Quick Start
+
+### 1. Start the MCP Server
+
+Run the startup script from the project root:
+
+```bash
+./scripts/start_mcp_server.sh
+```
+
+Or manually:
+
+```bash
+cd statuspro_mcp_server
+uv run python -m statuspro_mcp --transport sse --port 8765
+```
+
+The server will start on `http://127.0.0.1:8765/sse`
+
+### 2. Configure Cursor IDE
+
+The `.mcp.json` file in the project root is already configured to connect to the server:
+
+```json
+{
+  "mcpServers": {
+    "statuspro-erp": {
+      "type": "sse",
+      "url": "http://127.0.0.1:8765/sse"
+    }
+  }
+}
+```
+
+### 3. Restart Cursor IDE
+
+After starting the server, restart Cursor IDE to load the MCP configuration.
+
+## Configuration Options
+
+### Custom Port
+
+To use a different port:
+
+1. Start the server with custom port:
+
+   ```bash
+   ./scripts/start_mcp_server.sh --port 9000
+   ```
+
+1. Update `.mcp.json`:
+
+   ```json
+   "statuspro-erp": {
+     "type": "sse",
+     "url": "http://127.0.0.1:9000/sse"
+   }
+   ```
+
+### Custom Host
+
+To listen on all interfaces (for remote access):
+
+```bash
+./scripts/start_mcp_server.sh --host 0.0.0.0 --port 8765
+```
+
+**Security Note**: Only expose the server on public interfaces if you have proper
+authentication/authorization in place.
+
+### HTTP Transport
+
+To use HTTP transport instead of SSE:
+
+```bash
+./scripts/start_mcp_server.sh --transport http
+```
+
+Then update `.mcp.json`:
+
+```json
+"statuspro-erp": {
+  "type": "http",
+  "url": "http://127.0.0.1:8765"
+}
+```
+
+### Streamable HTTP Transport
+
+For Claude.ai co-work or other MCP clients that support streamable-http:
+
+```bash
+./scripts/start_mcp_server.sh --transport streamable-http
+```
+
+The server will be available at `http://127.0.0.1:8765/mcp`.
+
+## Environment Variables
+
+The server requires the following environment variables:
+
+- `STATUSPRO_API_KEY` (required): Your StatusPro API key
+- `STATUSPRO_BASE_URL` (optional): API base URL (default:
+  `https://app.orderstatuspro.com/api/v1`)
+
+Set them in your `.env` file or export them:
+
+```bash
+export STATUSPRO_API_KEY=your-api-key-here
+export STATUSPRO_BASE_URL=https://app.orderstatuspro.com/api/v1  # Optional
+```
+
+## Troubleshooting
+
+### Server won't start
+
+1. Check that `STATUSPRO_API_KEY` is set:
+
+   ```bash
+   echo $STATUSPRO_API_KEY
+   ```
+
+1. Verify dependencies are installed:
+
+   ```bash
+   cd statuspro_mcp_server
+   uv sync
+   ```
+
+1. Check if port is already in use:
+
+   ```bash
+   lsof -i :8765
+   ```
+
+### Cursor can't connect
+
+1. Verify the server is running:
+
+   ```bash
+   curl http://127.0.0.1:8765/sse
+   ```
+
+1. Check the URL in `.mcp.json` matches the server URL
+
+1. Restart Cursor IDE after configuration changes
+
+1. Check Cursor's MCP server logs for connection errors
+
+### Tools not appearing
+
+1. Verify the server started successfully (check startup logs)
+
+1. Ensure Cursor IDE has been restarted after configuration changes
+
+1. Check that the MCP server appears in Cursor's MCP server list
+
+## Development Mode
+
+For development with hot-reload, see [DEVELOPMENT.md](docs/development.md).
+
+## Production Deployment
+
+For production deployment, consider:
+
+- Running the server as a systemd service or similar
+- Using a reverse proxy (nginx, Caddy) for HTTPS
+- Implementing proper authentication/authorization
+- Setting up monitoring and logging
+
+See the [Docker documentation](docs/docker.md) for containerized deployment options.