mcp-contextforge-gateway 0.1.0__tar.gz

mcp_contextforge_gateway-0.1.0/.coveragerc

@@ -0,0 +1,14 @@
+[run]
+branch = True
+
+[report]
+exclude_lines =
+    pragma: no cover
+    def __repr__
+    if self.debug
+    raise AssertionError
+    raise NotImplentedError
+    if 0:
+    if __name__ == .__main__.:
+
+ignore_errors = True

mcp_contextforge_gateway-0.1.0/.darglint

@@ -0,0 +1,2 @@
+[darglint]
+docstring_style=google

mcp_contextforge_gateway-0.1.0/.dockerignore

@@ -0,0 +1,178 @@
+.github
+docker-compose.yml
+podman-compose-sonarqube.yaml
+
+node_modules
+docs/
+.vscode
+certs
+mcp.db
+public/
+# VENV
+.python37/
+.python39/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Bak
+*.bak
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.wily/
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# 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/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Mac junk
+.DS_Store
+
+# MYPY cache
+.mypy_cache
+.idea/
+
+# Sonar
+.scannerwork
+
+# vim
+*.swp
+*,cover
+
+# Development folders
+.git/
+attic/
+docs/
+test/
+tests/
+
+# Configuration files
+.bumpversion.cfg
+.coveragerc
+.editorconfig
+.flake8
+.hadolint.yaml
+.pre-commit-config.yaml
+.pycodestyle
+.pylintrc
+.pyre_configuration
+.pyspelling.yaml
+.ruff.toml
+.shellcheckrc
+.spellcheck-en.txt
+.travis.*
+.whitesource
+Makefile
+mypi.ini
+pytest.ini
+sonar-code.properties
+test.sh
+tox.ini
+whitesource.config
+
+# Misc
+TODO.md
+DEVELOPING.md

mcp_contextforge_gateway-0.1.0/.env.ce.example

@@ -0,0 +1,45 @@
+###############################################################################
+#  IBM Cloud Code Engine – deployment-only variables
+#  • Required *only* when you deploy MCP Gateway to IBM Cloud.
+#  • These keys are consumed by the Makefile / ibmcloud CLI and are **NOT**
+#    injected into the running container.
+#  • Copy this file to `.env.ce`, fill in real values, keep it out of Git.
+###############################################################################
+
+# ── Core IBM Cloud context ──────────────────────────────────────────────
+# Region where your Code Engine project lives (e.g. us-south, eu-de, au-syd)
+IBMCLOUD_REGION=us-south
+
+# Resource group that owns the project (often "default")
+IBMCLOUD_RESOURCE_GROUP=default
+
+# Code Engine project name
+IBMCLOUD_PROJECT=my-codeengine-project
+
+# Desired application name in Code Engine
+IBMCLOUD_CODE_ENGINE_APP=mcpgateway
+
+
+# ── Container image details ─────────────────────────────────────────────
+# Fully-qualified tag in IBM Container Registry
+IBMCLOUD_IMAGE_NAME=us.icr.io/myspace/mcpgateway:latest
+
+# Local tag produced by `make podman` or `make docker`
+IBMCLOUD_IMG_PROD=mcpgateway/mcpgateway
+
+
+# ── Authentication ──────────────────────────────────────────────────────
+# IAM API key for scripted logins.
+# Leave **blank** if you prefer interactive SSO (`ibmcloud login --sso`)
+IBMCLOUD_API_KEY=
+
+
+# ── Compute sizing (must match a valid CPU/MEM combo) ───────────────────
+# Reference table: https://cloud.ibm.com/docs/codeengine?topic=codeengine-mem-cpu-combo
+IBMCLOUD_CPU=1
+IBMCLOUD_MEMORY=4G
+
+
+# ── Registry secret ─────────────────────────────────────────────────────
+# Name for the pull secret Code Engine uses to fetch from ICR
+IBMCLOUD_REGISTRY_SECRET=my-regcred

mcp_contextforge_gateway-0.1.0/.env.example

@@ -0,0 +1,228 @@
+#####################################
+# Basic Application Settings
+#####################################
+
+# The public-facing name of your gateway (used in docs/UI)
+APP_NAME=MCP_Gateway
+
+# Bind address for HTTP server (0.0.0.0 for all interfaces)
+HOST=0.0.0.0
+
+# TCP port to listen on
+PORT=4444
+
+# SQLAlchemy connection string; leave as-is for local dev
+# Examples:
+#   sqlite:///./mcp.db        (local file-based)
+#   postgresql://user:pass@localhost:5432/mcp
+DATABASE_URL=sqlite:///./mcp.db
+
+# Optional root path for deployments under a subpath (e.g., /api)
+# Leave empty for default (/)
+# Example: APP_ROOT_PATH=/gateway
+APP_ROOT_PATH=
+
+#####################################
+# Database Connection Pooling
+#####################################
+
+# Size of the SQLAlchemy connection pool (default is 200)
+DB_POOL_SIZE=200
+
+# Number of extra connections allowed beyond pool size
+DB_MAX_OVERFLOW=10
+
+# Max time (in seconds) to wait for a connection from pool
+DB_POOL_TIMEOUT=30
+
+# Recycle database connections after N seconds
+DB_POOL_RECYCLE=3600
+
+#####################################
+# Cache Backend
+#####################################
+
+# Backend for caching (memory, redis, database, or none)
+CACHE_TYPE=database
+
+# If using Redis: provide full connection URL
+# Example: redis://localhost:6379/0
+REDIS_URL=redis://localhost:6379/0
+
+# Prefix for cache keys (recommended to avoid collisions)
+CACHE_PREFIX=mcpgw:
+
+# TTL for user sessions (in seconds)
+SESSION_TTL=3600
+
+# TTL for ephemeral messages (like completions) in seconds
+MESSAGE_TTL=600
+
+#####################################
+# Protocol Settings
+#####################################
+
+# MCP protocol version supported by this gateway
+PROTOCOL_VERSION=2025-03-26
+
+#####################################
+# Authentication
+#####################################
+
+# Admin UI basic-auth credentials
+BASIC_AUTH_USER=admin
+BASIC_AUTH_PASSWORD=changeme
+
+# Require any form of authentication (true or false)
+AUTH_REQUIRED=true
+
+# Secret used to sign JWTs (use long random value in prod)
+JWT_SECRET_KEY=my-test-key
+
+# Algorithm used to sign JWTs (e.g., HS256)
+JWT_ALGORITHM=HS256
+
+# Expiry time for generated JWT tokens (in minutes; e.g. 7 days)
+TOKEN_EXPIRY=10080
+
+# Used to derive an AES encryption key for secure auth storage
+# Must be a non-empty string (e.g. passphrase or random secret)
+AUTH_ENCRYPTION_SECRET=my-test-salt
+
+#####################################
+# Admin UI and API Toggles
+#####################################
+
+# Enable the visual Admin UI (true/false)
+MCPGATEWAY_UI_ENABLED=true
+
+# Enable the Admin API endpoints (true/false)
+MCPGATEWAY_ADMIN_API_ENABLED=true
+
+#####################################
+# Security and CORS
+#####################################
+
+# Skip TLS certificate checks for upstream requests (not recommended in prod)
+SKIP_SSL_VERIFY=false
+
+# CORS origin allowlist (use JSON array of URLs)
+# Example: ["http://localhost:3000"]
+# Do not quote this value. Start with [] to ensure it's valid JSON.
+ALLOWED_ORIGINS='["http://localhost", "http://localhost:4444"]'
+
+# Enable CORS handling in the gateway
+CORS_ENABLED=true
+
+#####################################
+# Logging
+#####################################
+
+# Logging verbosity level: DEBUG, INFO, WARNING, ERROR, CRITICAL
+LOG_LEVEL=INFO
+
+# Log format: json or text
+LOG_FORMAT=json
+
+# Optional path to write logs to file (leave empty to log to stdout)
+#LOG_FILE=./logs/gateway.log
+
+#####################################
+# Transport Configuration
+#####################################
+
+# Transport mechanisms to expose (comma-separated): http, ws, sse, stdio, all
+TRANSPORT_TYPE=all
+
+# WebSocket ping interval (seconds)
+WEBSOCKET_PING_INTERVAL=30
+
+# SSE client retry timeout (milliseconds)
+SSE_RETRY_TIMEOUT=5000
+
+#####################################
+# Federation
+#####################################
+
+# Enable federated mode (discovery + peer syncing)
+FEDERATION_ENABLED=true
+
+# Automatically discover peer gateways (e.g., via mDNS)
+FEDERATION_DISCOVERY=false
+
+# Explicit list of peers (JSON array of URLs). Do not quote this value.
+FEDERATION_PEERS='[]'
+
+# Timeout for federated requests (in seconds)
+FEDERATION_TIMEOUT=30
+
+# Frequency of syncing peers (in seconds)
+FEDERATION_SYNC_INTERVAL=300
+
+#####################################
+# Resources
+#####################################
+
+# Maximum number of resources to keep in memory cache
+RESOURCE_CACHE_SIZE=1000
+
+# Time-to-live for resource cache (seconds)
+RESOURCE_CACHE_TTL=3600
+
+# Maximum allowed size for a resource (in bytes, e.g., 10MB)
+MAX_RESOURCE_SIZE=10485760
+
+#####################################
+# Tools
+#####################################
+
+# Max execution time for tools (in seconds)
+TOOL_TIMEOUT=60
+
+# Number of retry attempts for failed tools
+MAX_TOOL_RETRIES=3
+
+# Max number of tool invocations per minute
+TOOL_RATE_LIMIT=100
+
+# Number of tools that can run simultaneously
+TOOL_CONCURRENT_LIMIT=10
+
+#####################################
+# Prompts
+#####################################
+
+# How many prompt templates to cache
+PROMPT_CACHE_SIZE=100
+
+# Max size (in bytes) for a prompt template
+MAX_PROMPT_SIZE=102400
+
+# Timeout for rendering prompt templates (in seconds)
+PROMPT_RENDER_TIMEOUT=10
+
+#####################################
+# Health Checks
+#####################################
+
+# How often to poll peer gateways (in seconds)
+HEALTH_CHECK_INTERVAL=60
+
+# Timeout for a single health check request (seconds)
+HEALTH_CHECK_TIMEOUT=10
+
+# Number of failed checks before marking peer unhealthy
+UNHEALTHY_THRESHOLD=3
+
+#####################################
+# Development Settings
+#####################################
+
+# Enable dev mode features (e.g. schema debug)
+DEV_MODE=false
+
+# Reload app on code changes (dev only)
+RELOAD=false
+
+# Enable verbose logging/debug traces
+DEBUG=false

mcp_contextforge_gateway-0.1.0/.eslintrc.json

@@ -0,0 +1,16 @@
+{
+  "root": true,
+  "env": {
+    "browser": true,
+    "es2021": true
+  },
+  "extends": ["standard"],
+  "parserOptions": {
+    "ecmaVersion": 12,
+    "sourceType": "module"
+  },
+  "rules": {
+    "semi": ["error", "always"],
+    "quotes": ["error", "double"]
+  }
+}

mcp_contextforge_gateway-0.1.0/.flake8

@@ -0,0 +1,2 @@
+[flake8]
+max-line-length = 600

mcp_contextforge_gateway-0.1.0/.hadolint.yaml

@@ -0,0 +1,2 @@
+ignored:
+  - SC1019

mcp_contextforge_gateway-0.1.0/.htmlhintrc

@@ -0,0 +1,7 @@
+{
+  "attr-value-double-quotes": true,
+  "tag-pair": true,
+  "doctype-first": true,
+  "id-unique": true,
+  "spec-char-escape": true
+}

mcp_contextforge_gateway-0.1.0/.markdownlint.json

@@ -0,0 +1,7 @@
+{
+  "default": true,
+  "MD003": { "style": "atx_closed" },
+  "MD007": { "indent": 4 },
+  "no-hard-tabs": false,
+  "whitespace": false
+}