objectstore-mcp 0.1.0__tar.gz

objectstore_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Knuckles-Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE 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
+AUTHORS OR COPYRIGHT HOLDERS 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 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

objectstore_mcp-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+include requirements.txt
+recursive-include objectstore_mcp *.py *.json

objectstore_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: objectstore-mcp
+Version: 0.1.0
+Summary: Object storage (S3/MinIO/R2, Google Cloud Storage, Azure Blob, local filesystem) API + MCP Server + A2A Server for Agentic AI!
+Author-email: Audel Rouhi <knucklessg1@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: <3.15,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: agent-utilities>=0.47.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: mcp
+Requires-Dist: agent-utilities[mcp]>=0.47.0; extra == "mcp"
+Provides-Extra: agent
+Requires-Dist: agent-utilities[agent,logfire]>=0.47.0; extra == "agent"
+Provides-Extra: s3
+Requires-Dist: boto3>=1.34.0; extra == "s3"
+Provides-Extra: gcs
+Requires-Dist: google-cloud-storage>=2.16.0; extra == "gcs"
+Provides-Extra: azure
+Requires-Dist: azure-storage-blob>=12.20.0; extra == "azure"
+Provides-Extra: all
+Requires-Dist: objectstore-mcp[agent,azure,gcs,logfire,mcp,s3]>=0.1.0; extra == "all"
+Provides-Extra: test
+Requires-Dist: pytest-xdist>=3.6.0; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: moto[s3]>=5.0.0; extra == "test"
+Dynamic: license-file
+
+# ObjectStore MCP
+## Multi-Backend Object Storage | MCP Server
+
+![PyPI - Version](https://img.shields.io/pypi/v/objectstore-mcp)
+![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server')
+![PyPI - License](https://img.shields.io/pypi/l/objectstore-mcp)
+
+The object-storage connector for the agent-utilities fleet: **one MCP tool
+surface over S3 and S3-compatible stores (MinIO, Cloudflare R2), Google Cloud
+Storage, Azure Blob Storage, and a zero-infra local-filesystem backend**.
+
+*Version: 0.1.0*
+
+> **Documentation** — Installation, deployment, and usage across the API, CLI, and
+> MCP interfaces are maintained in [`docs/`](docs/index.md).
+
+## Table of Contents
+
+- [Overview](#overview)
+- [What it provides](#what-it-provides)
+- [Backend × capability matrix](#backend--capability-matrix)
+- [Installation](#installation)
+- [Configuration (environment)](#configuration-environment)
+- [Usage](#usage)
+- [MCP config](#mcp-config)
+- [Docker deployment](#docker-deployment)
+- [Development](#development)
+- [License](#license)
+
+## Overview
+
+`objectstore-mcp` wraps heterogeneous object stores behind one typed,
+deterministic MCP tool surface, plus an optional Pydantic-AI A2A agent server
+(`objectstore-agent`). Safety caps, explicit buckets, and dry-run-by-default
+batch deletes are enforced uniformly in the tool layer, regardless of backend.
+
+## What it provides
+
+- **A multi-backend store abstraction** (`objectstore_mcp.api`,
+  CONCEPT:OBJ-1.0) — every provider implements the same
+  `ObjectStoreBackend` protocol, validated by a single conformance test
+  suite that runs for real against the filesystem backend.
+- **Three consolidated, action-routed MCP tools** (`objectstore-mcp`
+  console script):
+
+  | Tool | Actions | Description |
+  |---|---|---|
+  | `objects` | `list` (prefix/delimiter pagination), `head`, `get` (text/base64, size-capped), `put` (text/base64, size-capped), `copy`, `move`, `delete`, `delete_batch` (capped, dry-run by default), `presign`, `metadata_get`, `metadata_set` | Single-object lifecycle and listing on any store |
+  | `buckets` | `list`, `create`, `delete` (empty-only, opt-in), `exists`, `info`, `stores` | Bucket/container admin and store registry introspection |
+  | `transfer` | `upload`, `download`, `upload_dir`, `download_prefix` (all size/batch-capped) | Local-filesystem ⇄ object-store transfer, single or by prefix |
+
+  The whole tool set toggles with `OBJECTSTORETOOL`.
+
+- **Named multi-store routing** — `OBJECTSTORE_STORES` JSON maps store names
+  to `{backend, bucket?, endpoint?, profile?, ...}`; every tool takes an
+  optional `store` argument. A zero-infra `local` filesystem store always
+  exists, so the server works with no cloud credentials at all.
+- **A safety governor** — size caps on get/put/transfer, list/batch key caps,
+  deletes that demand an explicit bucket+key (no wildcards), batch deletes
+  that are prefix-scoped, capped, and dry-run by default, and bucket deletes
+  that are empty-only and disabled unless explicitly enabled.
+
+## Backend × capability matrix
+
+| Capability | filesystem | s3 / minio / r2 | gcs | azure |
+|---|---|---|---|---|
+| buckets (list/create/delete/exists/info) | yes | yes | yes | yes |
+| objects (list/head/get/put/copy/move/delete) | yes | yes | yes | yes |
+| prefix + delimiter listing, pagination | yes | yes | yes | yes |
+| user metadata get/set | yes | yes | yes | yes |
+| presigned URLs | no | yes | yes (needs service-account key) | yes (needs account key) |
+| bucket location | no | yes | yes | no |
+
+## Installation
+
+```bash
+pip install objectstore-mcp            # core: local filesystem backend only
+pip install objectstore-mcp[s3]        # + boto3 (S3, MinIO, R2)
+pip install objectstore-mcp[gcs]       # + google-cloud-storage
+pip install objectstore-mcp[azure]     # + azure-storage-blob
+pip install objectstore-mcp[all]       # everything (incl. MCP + agent extras)
+```
+
+Or pull the container image:
+
+```bash
+docker pull knucklessg1/objectstore-mcp:latest
+```
+
+## Configuration (environment)
+
+| Var | Default | Meaning |
+|---|---|---|
+| `OBJECTSTORE_STORES` | _(empty)_ | JSON: store name → `{backend, bucket?, endpoint?, profile?, region?, root?, project?, connection_string?}` |
+| `OBJECTSTORE_DEFAULT_STORE` | first configured store, else `local` | Store used when a tool call omits `store` |
+| `OBJECTSTORE_FS_ROOT` | `~/.local/share/objectstore-mcp` | Root of the implicit `local` filesystem store |
+| `OBJECTSTORE_MAX_GET_BYTES` | `10485760` (10 MiB) | Cap on `objects get` |
+| `OBJECTSTORE_MAX_PUT_BYTES` | `10485760` (10 MiB) | Cap on `objects put` |
+| `OBJECTSTORE_MAX_TRANSFER_BYTES` | `104857600` (100 MiB) | Cap per transfer (single or batch total) |
+| `OBJECTSTORE_MAX_BATCH_KEYS` | `100` | Cap on batch delete / dir transfer key counts |
+| `OBJECTSTORE_MAX_LIST_KEYS` | `1000` | Cap on one listing page |
+| `OBJECTSTORE_ALLOW_DELETE` | `true` | Object deletes (delete/delete_batch/move) |
+| `OBJECTSTORE_ALLOW_BUCKET_DELETE` | `false` | Bucket deletes (empty buckets only) |
+| `OBJECTSTORETOOL` | `True` | Register the objectstore tool set |
+| `HOST` / `PORT` / `TRANSPORT` | `0.0.0.0` / `8000` / `stdio` | MCP server bind + transport (`stdio`, `streamable-http`, `sse`) |
+| `AUTH_TYPE` | `none` | MCP auth mode (container image) |
+| `ENABLE_OTEL` | `True` | OTEL/Langfuse telemetry export |
+| `EUNOMIA_TYPE` / `EUNOMIA_POLICY_FILE` | `none` / `mcp_policies.json` | Eunomia access-governance middleware |
+| `DEFAULT_AGENT_NAME` / `AGENT_DESCRIPTION` / `AGENT_SYSTEM_PROMPT` | identity defaults | A2A agent server identity overrides |
+| `MCP_URL` | _(empty)_ | MCP endpoint the A2A agent connects to |
+
+Provider credentials resolve through each SDK's own chain — boto3's
+resolution order for S3 (env keys, `~/.aws` profiles via the store's
+`profile`, SSO, instance metadata), `GOOGLE_APPLICATION_CREDENTIALS` /
+Application Default Credentials for GCS, and
+`AZURE_STORAGE_CONNECTION_STRING` for Azure Blob.
+
+### Example store registry
+
+```json
+{
+  "media":   {"backend": "s3", "bucket": "media-prod", "profile": "prod", "region": "us-east-1"},
+  "minio":   {"backend": "s3", "endpoint": "http://minio.arpa:9000"},
+  "r2":      {"backend": "s3", "endpoint": "https://<account>.r2.cloudflarestorage.com"},
+  "reports": {"backend": "gcs", "bucket": "acme-reports"},
+  "archive": {"backend": "azure", "bucket": "archive"},
+  "scratch": {"backend": "filesystem", "root": "~/scratch-store"}
+}
+```
+
+## Usage
+
+```bash
+objectstore-mcp                                   # stdio
+objectstore-mcp --transport streamable-http --host 0.0.0.0 --port 8000
+```
+
+Example tool calls (any MCP client):
+
+```jsonc
+// Write then read a text object on the zero-infra local store
+{"tool": "buckets",  "arguments": {"action": "create", "params_json": "{\"bucket\": \"notes\"}"}}
+{"tool": "objects",  "arguments": {"action": "put",    "params_json": "{\"bucket\": \"notes\", \"key\": \"todo.md\", \"text\": \"- ship it\"}"}}
+{"tool": "objects",  "arguments": {"action": "get",    "params_json": "{\"bucket\": \"notes\", \"key\": \"todo.md\"}"}}
+
+// Preview then execute a prefix-scoped batch delete on a named S3 store
+{"tool": "objects", "arguments": {"store": "media", "action": "delete_batch", "params_json": "{\"bucket\": \"media-prod\", \"prefix\": \"tmp/\"}"}}
+{"tool": "objects", "arguments": {"store": "media", "action": "delete_batch", "params_json": "{\"bucket\": \"media-prod\", \"prefix\": \"tmp/\", \"dry_run\": false}"}}
+```
+
+## MCP config
+
+```json
+{
+  "mcpServers": {
+    "objectstore-mcp": {
+      "command": "uv",
+      "args": ["run", "objectstore-mcp"],
+      "env": {
+        "OBJECTSTORE_STORES": "{\"minio\": {\"backend\": \"s3\", \"endpoint\": \"http://minio.arpa:9000\"}}",
+        "OBJECTSTORE_DEFAULT_STORE": "local"
+      }
+    }
+  }
+}
+```
+
+Run the A2A agent server against a live MCP server:
+
+```bash
+objectstore-agent --mcp-url http://localhost:8000/mcp --host 0.0.0.0 --port 9001
+```
+
+## Docker deployment
+
+```bash
+docker compose -f docker/mcp.compose.yml up -d      # MCP server only
+docker compose -f docker/agent.compose.yml up -d    # MCP + A2A agent
+curl -s http://localhost:8000/health                 # {"status":"OK"}
+```
+
+Both services read configuration from `../.env` (copy
+[`.env.example`](.env.example)); see [`docs/deployment.md`](docs/deployment.md).
+
+## Development
+
+```bash
+pip install -e .[test]
+pytest                       # full suite (cloud SDKs not required)
+pip install -e .[test-s3]    # adds boto3+moto integration tests
+pre-commit run --all-files
+```
+
+See [`docs/`](docs/) for architecture, concepts, and deployment details.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

objectstore_mcp-0.1.0/README.md

@@ -0,0 +1,198 @@
+# ObjectStore MCP
+## Multi-Backend Object Storage | MCP Server
+
+![PyPI - Version](https://img.shields.io/pypi/v/objectstore-mcp)
+![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server')
+![PyPI - License](https://img.shields.io/pypi/l/objectstore-mcp)
+
+The object-storage connector for the agent-utilities fleet: **one MCP tool
+surface over S3 and S3-compatible stores (MinIO, Cloudflare R2), Google Cloud
+Storage, Azure Blob Storage, and a zero-infra local-filesystem backend**.
+
+*Version: 0.1.0*
+
+> **Documentation** — Installation, deployment, and usage across the API, CLI, and
+> MCP interfaces are maintained in [`docs/`](docs/index.md).
+
+## Table of Contents
+
+- [Overview](#overview)
+- [What it provides](#what-it-provides)
+- [Backend × capability matrix](#backend--capability-matrix)
+- [Installation](#installation)
+- [Configuration (environment)](#configuration-environment)
+- [Usage](#usage)
+- [MCP config](#mcp-config)
+- [Docker deployment](#docker-deployment)
+- [Development](#development)
+- [License](#license)
+
+## Overview
+
+`objectstore-mcp` wraps heterogeneous object stores behind one typed,
+deterministic MCP tool surface, plus an optional Pydantic-AI A2A agent server
+(`objectstore-agent`). Safety caps, explicit buckets, and dry-run-by-default
+batch deletes are enforced uniformly in the tool layer, regardless of backend.
+
+## What it provides
+
+- **A multi-backend store abstraction** (`objectstore_mcp.api`,
+  CONCEPT:OBJ-1.0) — every provider implements the same
+  `ObjectStoreBackend` protocol, validated by a single conformance test
+  suite that runs for real against the filesystem backend.
+- **Three consolidated, action-routed MCP tools** (`objectstore-mcp`
+  console script):
+
+  | Tool | Actions | Description |
+  |---|---|---|
+  | `objects` | `list` (prefix/delimiter pagination), `head`, `get` (text/base64, size-capped), `put` (text/base64, size-capped), `copy`, `move`, `delete`, `delete_batch` (capped, dry-run by default), `presign`, `metadata_get`, `metadata_set` | Single-object lifecycle and listing on any store |
+  | `buckets` | `list`, `create`, `delete` (empty-only, opt-in), `exists`, `info`, `stores` | Bucket/container admin and store registry introspection |
+  | `transfer` | `upload`, `download`, `upload_dir`, `download_prefix` (all size/batch-capped) | Local-filesystem ⇄ object-store transfer, single or by prefix |
+
+  The whole tool set toggles with `OBJECTSTORETOOL`.
+
+- **Named multi-store routing** — `OBJECTSTORE_STORES` JSON maps store names
+  to `{backend, bucket?, endpoint?, profile?, ...}`; every tool takes an
+  optional `store` argument. A zero-infra `local` filesystem store always
+  exists, so the server works with no cloud credentials at all.
+- **A safety governor** — size caps on get/put/transfer, list/batch key caps,
+  deletes that demand an explicit bucket+key (no wildcards), batch deletes
+  that are prefix-scoped, capped, and dry-run by default, and bucket deletes
+  that are empty-only and disabled unless explicitly enabled.
+
+## Backend × capability matrix
+
+| Capability | filesystem | s3 / minio / r2 | gcs | azure |
+|---|---|---|---|---|
+| buckets (list/create/delete/exists/info) | yes | yes | yes | yes |
+| objects (list/head/get/put/copy/move/delete) | yes | yes | yes | yes |
+| prefix + delimiter listing, pagination | yes | yes | yes | yes |
+| user metadata get/set | yes | yes | yes | yes |
+| presigned URLs | no | yes | yes (needs service-account key) | yes (needs account key) |
+| bucket location | no | yes | yes | no |
+
+## Installation
+
+```bash
+pip install objectstore-mcp            # core: local filesystem backend only
+pip install objectstore-mcp[s3]        # + boto3 (S3, MinIO, R2)
+pip install objectstore-mcp[gcs]       # + google-cloud-storage
+pip install objectstore-mcp[azure]     # + azure-storage-blob
+pip install objectstore-mcp[all]       # everything (incl. MCP + agent extras)
+```
+
+Or pull the container image:
+
+```bash
+docker pull knucklessg1/objectstore-mcp:latest
+```
+
+## Configuration (environment)
+
+| Var | Default | Meaning |
+|---|---|---|
+| `OBJECTSTORE_STORES` | _(empty)_ | JSON: store name → `{backend, bucket?, endpoint?, profile?, region?, root?, project?, connection_string?}` |
+| `OBJECTSTORE_DEFAULT_STORE` | first configured store, else `local` | Store used when a tool call omits `store` |
+| `OBJECTSTORE_FS_ROOT` | `~/.local/share/objectstore-mcp` | Root of the implicit `local` filesystem store |
+| `OBJECTSTORE_MAX_GET_BYTES` | `10485760` (10 MiB) | Cap on `objects get` |
+| `OBJECTSTORE_MAX_PUT_BYTES` | `10485760` (10 MiB) | Cap on `objects put` |
+| `OBJECTSTORE_MAX_TRANSFER_BYTES` | `104857600` (100 MiB) | Cap per transfer (single or batch total) |
+| `OBJECTSTORE_MAX_BATCH_KEYS` | `100` | Cap on batch delete / dir transfer key counts |
+| `OBJECTSTORE_MAX_LIST_KEYS` | `1000` | Cap on one listing page |
+| `OBJECTSTORE_ALLOW_DELETE` | `true` | Object deletes (delete/delete_batch/move) |
+| `OBJECTSTORE_ALLOW_BUCKET_DELETE` | `false` | Bucket deletes (empty buckets only) |
+| `OBJECTSTORETOOL` | `True` | Register the objectstore tool set |
+| `HOST` / `PORT` / `TRANSPORT` | `0.0.0.0` / `8000` / `stdio` | MCP server bind + transport (`stdio`, `streamable-http`, `sse`) |
+| `AUTH_TYPE` | `none` | MCP auth mode (container image) |
+| `ENABLE_OTEL` | `True` | OTEL/Langfuse telemetry export |
+| `EUNOMIA_TYPE` / `EUNOMIA_POLICY_FILE` | `none` / `mcp_policies.json` | Eunomia access-governance middleware |
+| `DEFAULT_AGENT_NAME` / `AGENT_DESCRIPTION` / `AGENT_SYSTEM_PROMPT` | identity defaults | A2A agent server identity overrides |
+| `MCP_URL` | _(empty)_ | MCP endpoint the A2A agent connects to |
+
+Provider credentials resolve through each SDK's own chain — boto3's
+resolution order for S3 (env keys, `~/.aws` profiles via the store's
+`profile`, SSO, instance metadata), `GOOGLE_APPLICATION_CREDENTIALS` /
+Application Default Credentials for GCS, and
+`AZURE_STORAGE_CONNECTION_STRING` for Azure Blob.
+
+### Example store registry
+
+```json
+{
+  "media":   {"backend": "s3", "bucket": "media-prod", "profile": "prod", "region": "us-east-1"},
+  "minio":   {"backend": "s3", "endpoint": "http://minio.arpa:9000"},
+  "r2":      {"backend": "s3", "endpoint": "https://<account>.r2.cloudflarestorage.com"},
+  "reports": {"backend": "gcs", "bucket": "acme-reports"},
+  "archive": {"backend": "azure", "bucket": "archive"},
+  "scratch": {"backend": "filesystem", "root": "~/scratch-store"}
+}
+```
+
+## Usage
+
+```bash
+objectstore-mcp                                   # stdio
+objectstore-mcp --transport streamable-http --host 0.0.0.0 --port 8000
+```
+
+Example tool calls (any MCP client):
+
+```jsonc
+// Write then read a text object on the zero-infra local store
+{"tool": "buckets",  "arguments": {"action": "create", "params_json": "{\"bucket\": \"notes\"}"}}
+{"tool": "objects",  "arguments": {"action": "put",    "params_json": "{\"bucket\": \"notes\", \"key\": \"todo.md\", \"text\": \"- ship it\"}"}}
+{"tool": "objects",  "arguments": {"action": "get",    "params_json": "{\"bucket\": \"notes\", \"key\": \"todo.md\"}"}}
+
+// Preview then execute a prefix-scoped batch delete on a named S3 store
+{"tool": "objects", "arguments": {"store": "media", "action": "delete_batch", "params_json": "{\"bucket\": \"media-prod\", \"prefix\": \"tmp/\"}"}}
+{"tool": "objects", "arguments": {"store": "media", "action": "delete_batch", "params_json": "{\"bucket\": \"media-prod\", \"prefix\": \"tmp/\", \"dry_run\": false}"}}
+```
+
+## MCP config
+
+```json
+{
+  "mcpServers": {
+    "objectstore-mcp": {
+      "command": "uv",
+      "args": ["run", "objectstore-mcp"],
+      "env": {
+        "OBJECTSTORE_STORES": "{\"minio\": {\"backend\": \"s3\", \"endpoint\": \"http://minio.arpa:9000\"}}",
+        "OBJECTSTORE_DEFAULT_STORE": "local"
+      }
+    }
+  }
+}
+```
+
+Run the A2A agent server against a live MCP server:
+
+```bash
+objectstore-agent --mcp-url http://localhost:8000/mcp --host 0.0.0.0 --port 9001
+```
+
+## Docker deployment
+
+```bash
+docker compose -f docker/mcp.compose.yml up -d      # MCP server only
+docker compose -f docker/agent.compose.yml up -d    # MCP + A2A agent
+curl -s http://localhost:8000/health                 # {"status":"OK"}
+```
+
+Both services read configuration from `../.env` (copy
+[`.env.example`](.env.example)); see [`docs/deployment.md`](docs/deployment.md).
+
+## Development
+
+```bash
+pip install -e .[test]
+pytest                       # full suite (cloud SDKs not required)
+pip install -e .[test-s3]    # adds boto3+moto integration tests
+pre-commit run --all-files
+```
+
+See [`docs/`](docs/) for architecture, concepts, and deployment details.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

objectstore_mcp-0.1.0/objectstore_mcp/__init__.py

@@ -0,0 +1,63 @@
+"""objectstore-mcp — multi-backend object-storage API + MCP Server + A2A Agent.
+
+One MCP tool surface (objects/buckets/transfer) over S3 and S3-compatible
+stores (MinIO, Cloudflare R2), Google Cloud Storage, Azure Blob Storage, and
+a zero-infra local-filesystem backend (CONCEPT:OBJ-1.0).
+"""
+
+import importlib
+import inspect
+from typing import Any
+
+__version__ = "0.1.0"
+__all__: list[str] = []
+
+CORE_MODULES = ["objectstore_mcp.api_client"]
+OPTIONAL_MODULES = {
+    "objectstore_mcp.agent_server": "agent",
+    "objectstore_mcp.mcp_server": "mcp",
+}
+
+
+def _expose_members(module):
+    for name, obj in inspect.getmembers(module):
+        if (inspect.isclass(obj) or inspect.isfunction(obj)) and not name.startswith(
+            "_"
+        ):
+            globals()[name] = obj
+            if name not in __all__:
+                __all__.append(name)
+
+
+for module_name in CORE_MODULES:
+    module = importlib.import_module(module_name)
+    _expose_members(module)
+
+_loaded_optional_modules: dict = {}
+
+
+def _import_module_safely(module_name: str):
+    try:
+        return importlib.import_module(module_name)
+    except ImportError:
+        return None
+
+
+def __getattr__(name: str) -> Any:
+    if name == "_MCP_AVAILABLE":
+        mcp_key = next((k for k in OPTIONAL_MODULES if "mcp_server" in k), None)
+        return _import_module_safely(mcp_key) is not None if mcp_key else False
+    if name == "_AGENT_AVAILABLE":
+        agent_key = next((k for k in OPTIONAL_MODULES if "agent_server" in k), None)
+        return _import_module_safely(agent_key) is not None if agent_key else False
+
+    for module_name in OPTIONAL_MODULES:
+        if module_name not in _loaded_optional_modules:
+            module = _import_module_safely(module_name)
+            _loaded_optional_modules[module_name] = module
+            if module is not None:
+                _expose_members(module)
+        module = _loaded_optional_modules[module_name]
+        if module is not None and hasattr(module, name):
+            return getattr(module, name)
+    raise AttributeError(f"module 'objectstore_mcp' has no attribute {name!r}")

objectstore_mcp-0.1.0/objectstore_mcp/__main__.py

@@ -0,0 +1,4 @@
+from objectstore_mcp.agent_server import agent_server
+
+if __name__ == "__main__":
+    agent_server()

objectstore_mcp-0.1.0/objectstore_mcp/agent_server.py

@@ -0,0 +1,73 @@
+#!/usr/bin/python
+import logging
+import os
+import sys
+import warnings
+
+__version__ = "0.1.0"
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+    handlers=[logging.StreamHandler()],
+)
+logger = logging.getLogger(__name__)
+
+
+def agent_server():
+    from agent_utilities import (
+        build_system_prompt_from_workspace,
+        create_agent_parser,
+        create_agent_server,
+        initialize_workspace,
+        load_identity,
+    )
+
+    warnings.filterwarnings("ignore", message=".*urllib3.*or chardet.*")
+    warnings.filterwarnings("ignore", category=DeprecationWarning, module="fastmcp")
+
+    initialize_workspace()
+    meta = load_identity()
+    agent_name = os.getenv("DEFAULT_AGENT_NAME", meta.get("name", "Objectstore Mcp"))
+
+    print(f"{agent_name} v{__version__}", file=sys.stderr)
+    parser = create_agent_parser()
+    args = parser.parse_args()
+
+    if args.debug:
+        logging.getLogger().setLevel(logging.DEBUG)
+        logger.debug("Debug mode enabled")
+
+    create_agent_server(
+        mcp_url=args.mcp_url,
+        mcp_config=args.mcp_config or "mcp_config.json",
+        host=args.host,
+        port=args.port,
+        provider=args.provider,
+        model_id=args.model_id,
+        router_model=args.model_id,
+        agent_model=args.model_id,
+        base_url=args.base_url,
+        api_key=args.api_key,
+        agent_description=os.getenv(
+            "AGENT_DESCRIPTION",
+            meta.get("description", "Objectstore Mcp API + MCP Server + A2A Server"),
+        ),
+        system_prompt=os.getenv(
+            "AGENT_SYSTEM_PROMPT",
+            meta.get("content") or build_system_prompt_from_workspace(),
+        ),
+        custom_skills_directory=args.custom_skills_directory,
+        enable_web_ui=args.web,
+        enable_otel=args.otel,
+        otel_endpoint=args.otel_endpoint,
+        otel_headers=args.otel_headers,
+        otel_public_key=args.otel_public_key,
+        otel_secret_key=args.otel_secret_key,
+        otel_protocol=args.otel_protocol,
+        debug=args.debug,
+    )
+
+
+if __name__ == "__main__":
+    agent_server()