airbyte-agent-mcp 0.1.7__tar.gz

airbyte_agent_mcp-0.1.7/.env.example

@@ -0,0 +1,3 @@
+# Copy to .env and fill in your actual values
+
+STRIPE_API_KEY=

airbyte_agent_mcp-0.1.7/.gitignore

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db

airbyte_agent_mcp-0.1.7/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+## [0.1.7] - 2025-12-10
+- Updated airbyte-agent-mcp package
+- Source commit: 30c77ce6
+- SDK version: 0.1.0
+
+## [0.1.6] - 2025-12-10
+- Updated airbyte-agent-mcp package
+- Source commit: 92482e66
+- SDK version: 0.1.0
+
+## [0.1.5] - 2025-12-10
+- Updated airbyte-agent-mcp package
+- Source commit: b3c6a176
+- SDK version: 0.1.0
+
+## [0.1.4] - 2025-12-10
+- Updated airbyte-agent-mcp package
+- Source commit: b3c6a176
+- SDK version: 0.1.0
+
+## [0.1.3] - 2025-12-10
+- Updated airbyte-agent-mcp package
+- Source commit: b3c6a176
+- SDK version: 0.1.0
+
+## [0.1.2] - 2025-12-10
+- Updated airbyte-agent-mcp package
+- Source commit: b3c6a176
+- SDK version: 0.1.0
+
+## [0.1.1] - 2025-12-10
+- Updated airbyte-agent-mcp package
+- Source commit: b3c6a176
+- SDK version: 0.1.0
+
+## [0.1.0] - 2025-12-09
+- Updated airbyte-agent-mcp package
+- Source commit: b3c6a176
+- SDK version: 0.1.0

airbyte_agent_mcp-0.1.7/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-mcp
+Version: 0.1.7
+Summary: MCP server that exposes Airbyte Connector SDK as MCP tools
+Author-email: Airbyte Support <support@airbyte.io>
+Requires-Python: >=3.13
+Requires-Dist: fastmcp>=2.10.5
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: jsonpath-ng>=1.6.1
+Requires-Dist: jsonref>=1.1.0
+Requires-Dist: opentelemetry-api>=1.37.0
+Requires-Dist: opentelemetry-sdk>=1.37.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: segment-analytics-python>=2.2.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio<1.0.0,>=0.24.0; extra == 'dev'
+Requires-Dist: pytest<9.0.0,>=8.3.3; extra == 'dev'
+Requires-Dist: ruff==0.7.3; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Airbyte Agent MCP Server
+
+MCP server that exposes the Airbyte Connector SDK as Model Context Protocol tools.
+
+## Features
+
+- **Execute**: Run operations on any connector (primary tool)
+- **List Entities**: Discover available entities in a connector
+- **Describe Entity**: Get detailed schema for an entity
+- **Validate Operation**: Check parameters before execution
+
+## Configuration
+
+### 1. Create configured_connectors.yaml
+
+```yaml
+# Connector definitions
+connectors:
+  # Load connector from the Airbyte registry (recommended)
+  - id: stripe
+    type: local
+    connector_name: stripe
+    description: "My Stripe API connector"
+    secrets:
+      token: STRIPE_API_KEY
+```
+
+You can pin to a specific version from the registry:
+
+```yaml
+connectors:
+  - id: stripe
+    type: local
+    connector_name: stripe
+    version: 0.1.0
+    description: "Stripe connector pinned to v0.1.0"
+    secrets:
+      token: STRIPE_API_KEY
+```
+
+You can also load connectors from a local file path (version pinning not supported):
+
+```yaml
+connectors:
+  - id: my_api
+    type: local
+    path: ./connectors/my-api/connector.yaml
+    description: "My custom API connector"
+    secrets:
+      token: MY_API_KEY
+```
+
+See `configured_connectors.yaml.example` for more examples.
+
+### 2. Create .env file
+
+```bash
+STRIPE_API_KEY=sk_test_your_stripe_api_key_here
+```
+
+## Running
+
+```bash
+uv run airbyte_agent_mcp
+```
+
+The server also takes in args for specific paths to the configured_connectors.yaml file and the env file. With custom paths:
+
+```bash
+python -m airbyte_agent_mcp path/to/configured_connectors.yaml path/to/.env
+```
+
+The default paths are `./configured_connectors.yaml` and `./.env`
+
+## Usage with Claude Code
+
+Add to `~/.claude.json`:
+
+```json
+"mcpServers": {
+  "airbyte-agent-mcp": {
+    "type": "stdio",
+    "command": "uv",
+    "args": [
+      "--directory",
+      "/path/to/sonar/airbyte-agent-mcp",
+      "run",
+      "airbyte_agent_mcp"
+    ],
+    "env": {}
+  }
+},
+```
+
+## Development / Testing
+
+```bash
+# Install dev dependencies
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Format code
+uv run ruff format .
+
+# Lint code
+uv run ruff check .
+```

airbyte_agent_mcp-0.1.7/README.md

@@ -0,0 +1,109 @@
+# Airbyte Agent MCP Server
+
+MCP server that exposes the Airbyte Connector SDK as Model Context Protocol tools.
+
+## Features
+
+- **Execute**: Run operations on any connector (primary tool)
+- **List Entities**: Discover available entities in a connector
+- **Describe Entity**: Get detailed schema for an entity
+- **Validate Operation**: Check parameters before execution
+
+## Configuration
+
+### 1. Create configured_connectors.yaml
+
+```yaml
+# Connector definitions
+connectors:
+  # Load connector from the Airbyte registry (recommended)
+  - id: stripe
+    type: local
+    connector_name: stripe
+    description: "My Stripe API connector"
+    secrets:
+      token: STRIPE_API_KEY
+```
+
+You can pin to a specific version from the registry:
+
+```yaml
+connectors:
+  - id: stripe
+    type: local
+    connector_name: stripe
+    version: 0.1.0
+    description: "Stripe connector pinned to v0.1.0"
+    secrets:
+      token: STRIPE_API_KEY
+```
+
+You can also load connectors from a local file path (version pinning not supported):
+
+```yaml
+connectors:
+  - id: my_api
+    type: local
+    path: ./connectors/my-api/connector.yaml
+    description: "My custom API connector"
+    secrets:
+      token: MY_API_KEY
+```
+
+See `configured_connectors.yaml.example` for more examples.
+
+### 2. Create .env file
+
+```bash
+STRIPE_API_KEY=sk_test_your_stripe_api_key_here
+```
+
+## Running
+
+```bash
+uv run airbyte_agent_mcp
+```
+
+The server also takes in args for specific paths to the configured_connectors.yaml file and the env file. With custom paths:
+
+```bash
+python -m airbyte_agent_mcp path/to/configured_connectors.yaml path/to/.env
+```
+
+The default paths are `./configured_connectors.yaml` and `./.env`
+
+## Usage with Claude Code
+
+Add to `~/.claude.json`:
+
+```json
+"mcpServers": {
+  "airbyte-agent-mcp": {
+    "type": "stdio",
+    "command": "uv",
+    "args": [
+      "--directory",
+      "/path/to/sonar/airbyte-agent-mcp",
+      "run",
+      "airbyte_agent_mcp"
+    ],
+    "env": {}
+  }
+},
+```
+
+## Development / Testing
+
+```bash
+# Install dev dependencies
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Format code
+uv run ruff format .
+
+# Lint code
+uv run ruff check .
+```

airbyte_agent_mcp-0.1.7/airbyte_agent_mcp/__main__.py

@@ -0,0 +1,26 @@
+"""Entry point for running airbyte-agent-mcp server."""
+
+import sys
+
+from airbyte_agent_mcp.server import run_server
+
+
+def main():
+    """Main entry point."""
+    # Support optional command-line arguments
+    config_path = "configured_connectors.yaml"
+    dotenv_path = ".env"
+
+    # Simple argument parsing
+    args = sys.argv[1:]
+    if len(args) >= 1:
+        config_path = args[0]
+    if len(args) >= 2:
+        dotenv_path = args[1]
+
+    # Run the server
+    run_server(config_path, dotenv_path)
+
+
+if __name__ == "__main__":
+    main()

airbyte_agent_mcp-0.1.7/airbyte_agent_mcp/_vendored/__init__.py

@@ -0,0 +1 @@
+"""Vendored connector-sdk runtime."""

airbyte_agent_mcp-0.1.7/airbyte_agent_mcp/_vendored/connector_sdk/__init__.py

@@ -0,0 +1,82 @@
+"""
+Airbyte SDK - Async-first type-safe connector execution framework.
+
+Provides:
+- Async executor for all connectors
+- Custom connector support
+- Performance monitoring and instrumentation
+- Connection pooling and concurrent execution
+"""
+
+from __future__ import annotations
+
+from .auth_strategies import AuthStrategy
+from .constants import SDK_VERSION
+from .executor import (
+    LocalExecutor,
+    HostedExecutor,
+    ExecutorProtocol,
+    ExecutionConfig,
+    ExecutionResult,
+    ExecutorError,
+    EntityNotFoundError,
+    ActionNotSupportedError,
+    MissingParameterError,
+    InvalidParameterError,
+)
+from .http_client import HTTPClient
+from .types import ConnectorConfig, Action, AuthType, EntityDefinition
+from .config_loader import load_connector_config
+from .logging import RequestLogger, NullLogger, RequestLog, LogSession
+from .performance import PerformanceMonitor, instrument
+from .exceptions import (
+    HTTPClientError,
+    AuthenticationError,
+    RateLimitError,
+    NetworkError,
+    TimeoutError,
+)
+from .utils import save_download
+
+__version__ = SDK_VERSION
+
+__all__ = [
+    # All Executors
+    "LocalExecutor",
+    "HostedExecutor",
+    "ExecutorProtocol",
+    "HTTPClient",
+    # Execution Config and Result Types
+    "ExecutionConfig",
+    "ExecutionResult",
+    # Types
+    "ConnectorConfig",
+    "Action",
+    "AuthType",
+    "EntityDefinition",
+    "load_connector_config",
+    # Authentication
+    "AuthStrategy",
+    # Executor Exceptions
+    "ExecutorError",
+    "EntityNotFoundError",
+    "ActionNotSupportedError",
+    "MissingParameterError",
+    "InvalidParameterError",
+    # HTTP Exceptions
+    "HTTPClientError",
+    "AuthenticationError",
+    "RateLimitError",
+    "NetworkError",
+    "TimeoutError",
+    # Logging
+    "RequestLogger",
+    "NullLogger",
+    "RequestLog",
+    "LogSession",
+    # Performance monitoring
+    "PerformanceMonitor",
+    "instrument",
+    # Utilities
+    "save_download",
+]