mxcp 0.1.0__tar.gz

mxcp-0.1.0/LICENSE

@@ -0,0 +1,40 @@
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             RAW Labs SA
+Licensed Work:        MXCP
+                      The Licensed Work is (c) 2025 RAW Labs SA
+Additional Use Grant: You may make use of the Licensed Work, provided that you may not use the Licensed Work for a Database Service.
+Change Date:          Four years from the date the Licensed Work is published.
+Change License:       MIT License
+
+For information about alternative licensing arrangements for the Software, please visit:
+https://raw-labs.com/licensing
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open Source license. However, the Licensed Work will eventually be released under an Open Source License, as stated in this License.
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative works, redistribute, and make non-production use of the Licensed Work. The Licensor may make an Additional Use Grant, above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly available distribution of a specific version of the Licensed Work under this License, whichever comes first, the Licensor hereby grants you rights under the terms of the Change License, and the rights granted in the paragraph above terminate.
+
+If your use of the Licensed Work does not comply with the requirements currently in effect as described in this License, you must purchase a commercial license from the Licensor, its affiliated entities, or authorized resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of the Licensed Work, are subject to this License. This License applies separately for each version of the Licensed Work and the Change Date may vary for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy of the Licensed Work. If you receive the Licensed Work in original or modified form from a third party, the terms and conditions set forth in this License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically terminate your rights under this License for the current and all other versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor or its affiliates (provided that you may use a trademark or logo of Licensor as expressly required by this License).
+
+THE LICENSED WORK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE LICENSED WORK.
+
+The Business Source License (this document, or the "License") is not an Open Source license. However, the Licensed Work will eventually be released under an Open Source License, as stated in this License. 

mxcp-0.1.0/PKG-INFO

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: mxcp
+Version: 0.1.0
+Summary: RAW Model Context Protocol
+Author-email: RAW Labs SA <hello@raw-labs.com>
+License: Business Source License 1.1
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.9.0
+Requires-Dist: click>=8.1.7
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: jsonschema
+Requires-Dist: duckdb>=0.9.2
+Requires-Dist: jinja2>=3.1.3
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: starlette>=0.27.0
+Requires-Dist: makefun
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: posthog>=3.0.0
+Requires-Dist: dbt-core>=1.6.0
+Requires-Dist: dbt-duckdb>=1.6.0
+Requires-Dist: cel-python>=0.2.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: pytest-timeout; extra == "dev"
+Requires-Dist: aioresponses; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: hvac>=2.0.0; extra == "dev"
+Provides-Extra: vault
+Requires-Dist: hvac>=2.0.0; extra == "vault"
+Dynamic: license-file
+
+# MXCP: Instantly Serve Your Operational Data to LLMs — Safely
+
+<div align="center">
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-BSL-green.svg)](LICENSE)
+
+**Transform your data into AI-ready interfaces in minutes, not months**
+
+</div>
+
+## ✨ Why MXCP?
+
+MXCP (Model eXecution + Context Protocol) is a developer-first tool that bridges the gap between your operational data and AI applications. It lets you:
+
+- 🚀 **Go from data to AI in minutes** — Define interfaces in YAML + SQL, serve instantly
+- 🔒 **Keep control of your data** — Run locally, with full observability and type safety
+- 🎯 **Build production-ready AI tools** — Combine real-time data, caching, and business logic
+- 🛠️ **Use familiar tools** — DuckDB for execution, dbt for modeling, Git for versioning
+
+## 🚀 Quick Start
+
+```bash
+# Install globally
+pip install mxcp
+
+# Install with Vault support (optional)
+pip install "mxcp[vault]"
+
+# Or develop locally
+git clone https://github.com/raw-labs/mxcp.git && cd mxcp
+python -m venv .venv && source .venv/bin/activate
+pip install -e .
+```
+
+Try the included Earthquakes example:
+```bash
+cd examples/earthquakes
+mxcp serve
+```
+
+## 💡 Key Features
+
+### 1. Declarative Interface Definition
+```yaml
+# tools/summarize_earthquakes.yml
+mxcp: "1.0.0"
+tool:
+  name: summarize_earthquakes
+  description: "Summarize earthquakes for a given date"
+  parameters:
+    - name: date
+      type: string
+      format: date
+      description: "Date to summarize earthquakes for"
+  return:
+    type: object
+    properties:
+      summary:
+        type: string
+        description: "Summary of earthquakes for the date"
+  source:
+    code: |
+      SELECT 'Summary for ' || $date || ': ' || COUNT(*) || ' earthquakes' AS summary
+      FROM earthquakes
+      WHERE event_date = $date
+```
+
+- **Type-safe** — Strong typing for LLM safety and schema tracing
+- **Fast restart** — Quick server restarts for development
+- **dbt integration** — Directly use your dbt models in endpoints
+
+### 2. Powerful Data Engine
+- **DuckDB-powered** — Run instantly, with no infrastructure
+- **Rich integrations** — PostgreSQL, Parquet, CSV, JSON, HTTP, S3, and more
+- **Full SQL support** — Joins, filters, aggregations, UDFs
+
+### 3. Production-Ready Features
+- **dbt integration** — Use your data models directly
+- **Git-based workflow** — Version control and collaboration
+- **Validation tools** — Type checking, SQL linting, and testing
+- **Drift detection** — Monitor schema and endpoint changes across environments
+
+## 🛠️ Core Concepts
+
+### Tools, Resources, Prompts
+Define your AI interface using MCP (Model Context Protocol) specs:
+- **Tools** — Functions that process data and return results
+- **Resources** — Data sources and caches
+- **Prompts** — Templates for LLM interactions
+
+### Project Structure
+```
+your-project/
+├── mxcp-site.yml    # Project configuration
+├── tools/           # Tool definitions
+├── resources/       # Data sources
+├── prompts/         # LLM templates
+└── models/          # (Optional) dbt transformations & caches
+```
+
+### CLI Commands
+```bash
+mxcp serve           # Start local MCP server
+mxcp list            # List all endpoints
+mxcp validate        # Check types, SQL, and references
+mxcp test            # Run endpoint tests
+mxcp query           # Execute SQL queries
+mxcp init            # Initialize new project
+mxcp dbt-config      # Configure dbt integration
+mxcp dbt             # Run dbt commands
+mxcp drift-snapshot  # Create drift detection baseline
+mxcp drift-check     # Check for schema and endpoint drift
+mxcp log             # Query audit logs
+```
+
+## 🔌 LLM Integration
+
+MXCP implements the Model Context Protocol (MCP), making it compatible with:
+
+- **Claude Desktop** — Native MCP support
+- **OpenAI-compatible tools** — Via MCP adapters
+- **Custom integrations** — Using the MCP specification
+
+For specific setup instructions, see:
+- [Earthquakes Example](examples/earthquakes/README.md) — Complete Claude Desktop setup walkthrough
+- [Integration Guide](docs/integrations.md) — Claude Desktop, OpenAI, mcp-cli, and custom integrations
+
+## 📚 Documentation
+
+- [Overview](docs/overview.md) — Core concepts and architecture
+- [Quickstart](docs/quickstart.md) — Get up and running
+- [CLI Reference](docs/cli.md) — Command-line tools
+- [Configuration](docs/configuration.md) — Project setup
+- [Plugins](docs/plugins.md) — Extend DuckDB with custom Python functions
+- [Authentication](docs/authentication.md) — OAuth authentication setup
+- [Policy Enforcement](docs/policies.md) — Access control and data filtering
+- [Audit Logging](docs/auditing.md) — Enterprise-grade execution logging
+- [Type System](docs/type-system.md) — Data types and validation
+- [Integrations](docs/integrations.md) — Data sources and tools
+- [Drift Detection](docs/drift-detection.md) — Schema and endpoint change monitoring
+
+## 🤝 Contributing
+
+We welcome contributions! See our [development guide](docs/dev-guide.md) to get started.
+
+## 🧠 About
+
+MXCP is developed by RAW Labs, combining the best of:
+- dbt's modular data modeling
+- DuckDB's speed and connectors
+- Python MCP official server
+- Modern AI-native workflows

mxcp-0.1.0/README.md

@@ -0,0 +1,153 @@
+# MXCP: Instantly Serve Your Operational Data to LLMs — Safely
+
+<div align="center">
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-BSL-green.svg)](LICENSE)
+
+**Transform your data into AI-ready interfaces in minutes, not months**
+
+</div>
+
+## ✨ Why MXCP?
+
+MXCP (Model eXecution + Context Protocol) is a developer-first tool that bridges the gap between your operational data and AI applications. It lets you:
+
+- 🚀 **Go from data to AI in minutes** — Define interfaces in YAML + SQL, serve instantly
+- 🔒 **Keep control of your data** — Run locally, with full observability and type safety
+- 🎯 **Build production-ready AI tools** — Combine real-time data, caching, and business logic
+- 🛠️ **Use familiar tools** — DuckDB for execution, dbt for modeling, Git for versioning
+
+## 🚀 Quick Start
+
+```bash
+# Install globally
+pip install mxcp
+
+# Install with Vault support (optional)
+pip install "mxcp[vault]"
+
+# Or develop locally
+git clone https://github.com/raw-labs/mxcp.git && cd mxcp
+python -m venv .venv && source .venv/bin/activate
+pip install -e .
+```
+
+Try the included Earthquakes example:
+```bash
+cd examples/earthquakes
+mxcp serve
+```
+
+## 💡 Key Features
+
+### 1. Declarative Interface Definition
+```yaml
+# tools/summarize_earthquakes.yml
+mxcp: "1.0.0"
+tool:
+  name: summarize_earthquakes
+  description: "Summarize earthquakes for a given date"
+  parameters:
+    - name: date
+      type: string
+      format: date
+      description: "Date to summarize earthquakes for"
+  return:
+    type: object
+    properties:
+      summary:
+        type: string
+        description: "Summary of earthquakes for the date"
+  source:
+    code: |
+      SELECT 'Summary for ' || $date || ': ' || COUNT(*) || ' earthquakes' AS summary
+      FROM earthquakes
+      WHERE event_date = $date
+```
+
+- **Type-safe** — Strong typing for LLM safety and schema tracing
+- **Fast restart** — Quick server restarts for development
+- **dbt integration** — Directly use your dbt models in endpoints
+
+### 2. Powerful Data Engine
+- **DuckDB-powered** — Run instantly, with no infrastructure
+- **Rich integrations** — PostgreSQL, Parquet, CSV, JSON, HTTP, S3, and more
+- **Full SQL support** — Joins, filters, aggregations, UDFs
+
+### 3. Production-Ready Features
+- **dbt integration** — Use your data models directly
+- **Git-based workflow** — Version control and collaboration
+- **Validation tools** — Type checking, SQL linting, and testing
+- **Drift detection** — Monitor schema and endpoint changes across environments
+
+## 🛠️ Core Concepts
+
+### Tools, Resources, Prompts
+Define your AI interface using MCP (Model Context Protocol) specs:
+- **Tools** — Functions that process data and return results
+- **Resources** — Data sources and caches
+- **Prompts** — Templates for LLM interactions
+
+### Project Structure
+```
+your-project/
+├── mxcp-site.yml    # Project configuration
+├── tools/           # Tool definitions
+├── resources/       # Data sources
+├── prompts/         # LLM templates
+└── models/          # (Optional) dbt transformations & caches
+```
+
+### CLI Commands
+```bash
+mxcp serve           # Start local MCP server
+mxcp list            # List all endpoints
+mxcp validate        # Check types, SQL, and references
+mxcp test            # Run endpoint tests
+mxcp query           # Execute SQL queries
+mxcp init            # Initialize new project
+mxcp dbt-config      # Configure dbt integration
+mxcp dbt             # Run dbt commands
+mxcp drift-snapshot  # Create drift detection baseline
+mxcp drift-check     # Check for schema and endpoint drift
+mxcp log             # Query audit logs
+```
+
+## 🔌 LLM Integration
+
+MXCP implements the Model Context Protocol (MCP), making it compatible with:
+
+- **Claude Desktop** — Native MCP support
+- **OpenAI-compatible tools** — Via MCP adapters
+- **Custom integrations** — Using the MCP specification
+
+For specific setup instructions, see:
+- [Earthquakes Example](examples/earthquakes/README.md) — Complete Claude Desktop setup walkthrough
+- [Integration Guide](docs/integrations.md) — Claude Desktop, OpenAI, mcp-cli, and custom integrations
+
+## 📚 Documentation
+
+- [Overview](docs/overview.md) — Core concepts and architecture
+- [Quickstart](docs/quickstart.md) — Get up and running
+- [CLI Reference](docs/cli.md) — Command-line tools
+- [Configuration](docs/configuration.md) — Project setup
+- [Plugins](docs/plugins.md) — Extend DuckDB with custom Python functions
+- [Authentication](docs/authentication.md) — OAuth authentication setup
+- [Policy Enforcement](docs/policies.md) — Access control and data filtering
+- [Audit Logging](docs/auditing.md) — Enterprise-grade execution logging
+- [Type System](docs/type-system.md) — Data types and validation
+- [Integrations](docs/integrations.md) — Data sources and tools
+- [Drift Detection](docs/drift-detection.md) — Schema and endpoint change monitoring
+
+## 🤝 Contributing
+
+We welcome contributions! See our [development guide](docs/dev-guide.md) to get started.
+
+## 🧠 About
+
+MXCP is developed by RAW Labs, combining the best of:
+- dbt's modular data modeling
+- DuckDB's speed and connectors
+- Python MCP official server
+- Modern AI-native workflows

mxcp-0.1.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mxcp"
+version = "0.1.0"
+description = "RAW Model Context Protocol"
+authors = [{ name = "RAW Labs SA", email = "hello@raw-labs.com" }]
+readme = "README.md"
+license = { text = "Business Source License 1.1" }
+requires-python = ">=3.9"
+dependencies = [
+    "mcp>=1.9.0",  # Official MCP Python SDK
+    "click>=8.1.7",
+    "pyyaml>=6.0.1",
+    "jsonschema",
+    "duckdb>=0.9.2",
+    "jinja2>=3.1.3",
+    "aiohttp>=3.8.0",  # Required for MCP HTTP transport
+    "starlette>=0.27.0",  # Required for MCP HTTP transport
+    "makefun",
+    "pandas>=2.0.0",  # Required for DuckDB DataFrame operations
+    "posthog>=3.0.0",  # For anonymous usage analytics
+    "dbt-core>=1.6.0",  # dbt core for data transformations
+    "dbt-duckdb>=1.6.0",  # dbt DuckDB adapter
+    "cel-python>=0.2.0"  # Common Expression Language for policy enforcement
+]
+
+[project.scripts]
+mxcp = "mxcp.__main__:cli"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-asyncio",  # For testing async code
+    "pytest-cov",  # For test coverage
+    "pytest-mock",  # For better mock integration with pytest
+    "pytest-timeout",  # For test timeout protection
+    "aioresponses",  # For mocking HTTP requests
+    "black",  # For code formatting
+    "isort",  # For import sorting
+    "mypy",  # For type checking
+    "hvac>=2.0.0",  # For testing Vault integration
+]
+vault = [
+    "hvac>=2.0.0",  # HashiCorp Vault client for vault:// URL support
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+packages = ["mxcp", "mxcp.audit", "mxcp.cli", "mxcp.config", "mxcp.config.schemas", "mxcp.server", "mxcp.auth", "mxcp.drift", "mxcp.endpoints", "mxcp.engine", "mxcp.plugins", "mxcp.policies"]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"mxcp.config.schemas" = ["*.json"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = "-v"
+asyncio_mode = "auto"  # Enable async test support
+
+[tool.black]
+line-length = 100
+target-version = ["py39"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true

mxcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mxcp-0.1.0/src/mxcp/__main__.py

@@ -0,0 +1,33 @@
+import click
+from mxcp.cli.list import list_endpoints
+from mxcp.cli.run import run_endpoint
+from mxcp.cli.validate import validate
+from mxcp.cli.test import test
+from mxcp.cli.serve import serve
+from mxcp.cli.init import init
+from mxcp.cli.query import query
+from mxcp.cli.dbt import dbt_config, dbt_wrapper
+from mxcp.config.analytics import initialize_analytics, track_base_command
+from mxcp.cli.drift_snapshot import drift_snapshot
+from mxcp.cli.drift_check import drift_check
+from mxcp.cli.log import log
+
+@click.group()
+def cli():
+    """MXCP CLI"""
+    initialize_analytics()
+    # Track when user runs just 'mxcp' without any command
+    track_base_command()
+
+cli.add_command(list_endpoints)
+cli.add_command(run_endpoint)
+cli.add_command(validate)
+cli.add_command(test)
+cli.add_command(serve)
+cli.add_command(init)
+cli.add_command(query)
+cli.add_command(dbt_config)
+cli.add_command(dbt_wrapper)
+cli.add_command(drift_snapshot)
+cli.add_command(drift_check)
+cli.add_command(log)

mxcp-0.1.0/src/mxcp/audit/__init__.py

@@ -0,0 +1,5 @@
+"""MXCP Audit Logging System - Enterprise-grade audit logging for tool, resource, and prompt executions."""
+
+from .logger import AuditLogger, LogEvent
+
+__all__ = ["AuditLogger", "LogEvent"]