objectstore-mcp 2.3.6__tar.gz → 2.3.7__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/PKG-INFO +9 -9
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/README.md +7 -7
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/__init__.py +1 -1
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/__main__.py +1 -1
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/auth.py +3 -3
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/connector_sources.py +1 -1
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/kg_ingest.py +2 -2
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/__init__.py +2 -2
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/certification.json +2 -2
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/objectstore.ttl +1 -1
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-bucket-administration/SKILL.md +1 -1
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-data-transfer/SKILL.md +1 -1
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-mcp-development/SKILL.md +2 -2
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-object-operations/SKILL.md +1 -1
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp.egg-info/PKG-INFO +9 -9
- objectstore_mcp-2.3.7/objectstore_mcp.egg-info/entry_points.txt +5 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp.egg-info/requires.txt +1 -1
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/pyproject.toml +5 -5
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_identity_context_scoping.py +4 -4
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_kg_ingest.py +5 -8
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_publication_workflow.py +1 -35
- objectstore_mcp-2.3.6/objectstore_mcp.egg-info/entry_points.txt +0 -5
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/LICENSE +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/api/__init__.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/api/api_client_azure_blob.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/api/api_client_base.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/api/api_client_filesystem.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/api/api_client_gcs.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/api/api_client_s3.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/api_client.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/config.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/mcp/__init__.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/mcp/mcp_objectstore.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/mcp_config.json +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/mcp_server.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/objectstore_input_models.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/objectstore_response_models.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/fixtures/records.json +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/mappings/source.yaml +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/migrations/manifest.json +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/shapes/connector.shacl.ttl +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-bucket-administration/WORKFLOW.md +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-data-transfer/WORKFLOW.md +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-mcp-operations/SKILL.md +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-mcp-operations/agents/openai.yaml +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-mcp-operations/references/catalog.md +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/skills/objectstore-object-operations/WORKFLOW.md +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp.egg-info/SOURCES.txt +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp.egg-info/dependency_links.txt +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp.egg-info/top_level.txt +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/setup.cfg +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_api_wrapper.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_auth.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_azure_backend.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_backend_conformance.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_config.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_gcs_backend.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_init_dynamics.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_objectstore_mcp_validation.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_optional_dependencies.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_s3_backend.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_s3_moto.py +0 -0
- {objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/tests/test_safety.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: objectstore-mcp
|
|
3
|
-
Version: 2.3.
|
|
3
|
+
Version: 2.3.7
|
|
4
4
|
Summary: Object storage (S3/MinIO/R2, Google Cloud Storage, Azure Blob, local filesystem) API + MCP Server for Agentic AI!
|
|
5
5
|
Author-email: Repository Maintainers <maintainers@knuckles.team>
|
|
6
6
|
License: MIT
|
|
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3
|
|
|
12
12
|
Requires-Python: >=3.12
|
|
13
13
|
Description-Content-Type: text/markdown
|
|
14
14
|
License-File: LICENSE
|
|
15
|
-
Requires-Dist:
|
|
15
|
+
Requires-Dist: scion-sdk[mcp]<0.7.0,>=0.6.3
|
|
16
16
|
Requires-Dist: python-dotenv>=1.2.4
|
|
17
17
|
Provides-Extra: s3
|
|
18
18
|
Requires-Dist: boto3>=1.43.114; extra == "s3"
|
|
@@ -37,7 +37,7 @@ Dynamic: license-file
|
|
|
37
37
|

|
|
38
38
|

|
|
39
39
|
|
|
40
|
-
The object-storage connector for the
|
|
40
|
+
The object-storage connector for the scion-sdk fleet: **one MCP tool
|
|
41
41
|
surface over S3 and S3-compatible stores (MinIO, Cloudflare R2), Google Cloud
|
|
42
42
|
Storage, Azure Blob Storage, and a zero-infra local-filesystem backend**.
|
|
43
43
|
|
|
@@ -91,7 +91,7 @@ batch deletes are enforced uniformly in the tool layer, in either case of backen
|
|
|
91
91
|
|
|
92
92
|
## Available MCP Tools
|
|
93
93
|
|
|
94
|
-
<!-- This table is auto-generated by `python -m
|
|
94
|
+
<!-- This table is auto-generated by `python -m scion_sdk.mcp.readme_tools` — do not edit by hand. -->
|
|
95
95
|
|
|
96
96
|
<!-- MCP-TOOLS-TABLE:START -->
|
|
97
97
|
|
|
@@ -148,7 +148,7 @@ Pick the extra that matches what the operator want to run (provider extras are a
|
|
|
148
148
|
|
|
149
149
|
| Extra | Installs | Use when |
|
|
150
150
|
|-------|----------|----------|
|
|
151
|
-
| `objectstore-mcp[mcp]` | Connector-focused MCP server (`
|
|
151
|
+
| `objectstore-mcp[mcp]` | Connector-focused MCP server (`scion-sdk` — FastMCP/FastAPI + `epistemic-graph[full]`) | The operator only run the **MCP server** (smallest install / image) |
|
|
152
152
|
| `objectstore-mcp[all]` | Everything (`mcp` + `agent` + `s3` + `gcs` + `azure` + `logfire`) | Development / both surfaces |
|
|
153
153
|
|
|
154
154
|
```bash
|
|
@@ -186,7 +186,7 @@ docker pull example/objectstore-mcp@sha256:<digest> # agent runtime (default)
|
|
|
186
186
|
|
|
187
187
|
### Knowledge-graph database (`epistemic-graph`)
|
|
188
188
|
|
|
189
|
-
|
|
189
|
+
Scion SDK core dependency (`epistemic-graph[full]`). The `[mcp]` extra keeps
|
|
190
190
|
deployments can use the bundled engine. For production or shared state, run
|
|
191
191
|
**epistemic-graph as a dedicated database service** and configure the runtime to use it.
|
|
192
192
|
Deployment recipes (single-node + Raft HA), connection configuration, and architecture
|
|
@@ -256,7 +256,7 @@ Example tool calls (any MCP client):
|
|
|
256
256
|
## MCP config
|
|
257
257
|
|
|
258
258
|
> **Install the connector-focused `[mcp]` extra.** Examples use `objectstore-mcp[mcp]` to add
|
|
259
|
-
> FastMCP / FastAPI through `
|
|
259
|
+
> FastMCP / FastAPI through `scion-sdk`; the required Scion SDK core
|
|
260
260
|
> enables model orchestration.
|
|
261
261
|
> Combine it with the storage-provider extras needed by the deployment.
|
|
262
262
|
|
|
@@ -358,7 +358,7 @@ MIT — see [LICENSE](LICENSE).
|
|
|
358
358
|
| `MCP_URL` | `http://localhost:8000/mcp` | |
|
|
359
359
|
| `OBJECTSTORETOOL` | `True` | |
|
|
360
360
|
|
|
361
|
-
#### Inherited
|
|
361
|
+
#### Inherited scion-sdk variables (apply to every connector)
|
|
362
362
|
|
|
363
363
|
| Variable | Example | Description |
|
|
364
364
|
|----------|---------|-------------|
|
|
@@ -378,7 +378,7 @@ MIT — see [LICENSE](LICENSE).
|
|
|
378
378
|
| `MODEL_ID` | `gpt-4o` | Model id for the agent |
|
|
379
379
|
| `ENABLE_WEB_UI` | `True` | Serve the AG-UI web interface |
|
|
380
380
|
|
|
381
|
-
_27 package + 15 inherited variable(s). Auto-generated from `.env.example` + the shared
|
|
381
|
+
_27 package + 15 inherited variable(s). Auto-generated from `.env.example` + the shared scion-sdk set — do not edit._
|
|
382
382
|
<!-- ENV-VARS-TABLE:END -->
|
|
383
383
|
|
|
384
384
|
<!-- GOVERNED-CAPABILITY:START -->
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|

|
|
6
6
|

|
|
7
7
|
|
|
8
|
-
The object-storage connector for the
|
|
8
|
+
The object-storage connector for the scion-sdk fleet: **one MCP tool
|
|
9
9
|
surface over S3 and S3-compatible stores (MinIO, Cloudflare R2), Google Cloud
|
|
10
10
|
Storage, Azure Blob Storage, and a zero-infra local-filesystem backend**.
|
|
11
11
|
|
|
@@ -59,7 +59,7 @@ batch deletes are enforced uniformly in the tool layer, in either case of backen
|
|
|
59
59
|
|
|
60
60
|
## Available MCP Tools
|
|
61
61
|
|
|
62
|
-
<!-- This table is auto-generated by `python -m
|
|
62
|
+
<!-- This table is auto-generated by `python -m scion_sdk.mcp.readme_tools` — do not edit by hand. -->
|
|
63
63
|
|
|
64
64
|
<!-- MCP-TOOLS-TABLE:START -->
|
|
65
65
|
|
|
@@ -116,7 +116,7 @@ Pick the extra that matches what the operator want to run (provider extras are a
|
|
|
116
116
|
|
|
117
117
|
| Extra | Installs | Use when |
|
|
118
118
|
|-------|----------|----------|
|
|
119
|
-
| `objectstore-mcp[mcp]` | Connector-focused MCP server (`
|
|
119
|
+
| `objectstore-mcp[mcp]` | Connector-focused MCP server (`scion-sdk` — FastMCP/FastAPI + `epistemic-graph[full]`) | The operator only run the **MCP server** (smallest install / image) |
|
|
120
120
|
| `objectstore-mcp[all]` | Everything (`mcp` + `agent` + `s3` + `gcs` + `azure` + `logfire`) | Development / both surfaces |
|
|
121
121
|
|
|
122
122
|
```bash
|
|
@@ -154,7 +154,7 @@ docker pull example/objectstore-mcp@sha256:<digest> # agent runtime (default)
|
|
|
154
154
|
|
|
155
155
|
### Knowledge-graph database (`epistemic-graph`)
|
|
156
156
|
|
|
157
|
-
|
|
157
|
+
Scion SDK core dependency (`epistemic-graph[full]`). The `[mcp]` extra keeps
|
|
158
158
|
deployments can use the bundled engine. For production or shared state, run
|
|
159
159
|
**epistemic-graph as a dedicated database service** and configure the runtime to use it.
|
|
160
160
|
Deployment recipes (single-node + Raft HA), connection configuration, and architecture
|
|
@@ -224,7 +224,7 @@ Example tool calls (any MCP client):
|
|
|
224
224
|
## MCP config
|
|
225
225
|
|
|
226
226
|
> **Install the connector-focused `[mcp]` extra.** Examples use `objectstore-mcp[mcp]` to add
|
|
227
|
-
> FastMCP / FastAPI through `
|
|
227
|
+
> FastMCP / FastAPI through `scion-sdk`; the required Scion SDK core
|
|
228
228
|
> enables model orchestration.
|
|
229
229
|
> Combine it with the storage-provider extras needed by the deployment.
|
|
230
230
|
|
|
@@ -326,7 +326,7 @@ MIT — see [LICENSE](LICENSE).
|
|
|
326
326
|
| `MCP_URL` | `http://localhost:8000/mcp` | |
|
|
327
327
|
| `OBJECTSTORETOOL` | `True` | |
|
|
328
328
|
|
|
329
|
-
#### Inherited
|
|
329
|
+
#### Inherited scion-sdk variables (apply to every connector)
|
|
330
330
|
|
|
331
331
|
| Variable | Example | Description |
|
|
332
332
|
|----------|---------|-------------|
|
|
@@ -346,7 +346,7 @@ MIT — see [LICENSE](LICENSE).
|
|
|
346
346
|
| `MODEL_ID` | `gpt-4o` | Model id for the agent |
|
|
347
347
|
| `ENABLE_WEB_UI` | `True` | Serve the AG-UI web interface |
|
|
348
348
|
|
|
349
|
-
_27 package + 15 inherited variable(s). Auto-generated from `.env.example` + the shared
|
|
349
|
+
_27 package + 15 inherited variable(s). Auto-generated from `.env.example` + the shared scion-sdk set — do not edit._
|
|
350
350
|
<!-- ENV-VARS-TABLE:END -->
|
|
351
351
|
|
|
352
352
|
<!-- GOVERNED-CAPABILITY:START -->
|
|
@@ -5,7 +5,7 @@ stores (MinIO, Cloudflare R2), Google Cloud Storage, Azure Blob Storage, and
|
|
|
5
5
|
a zero-infra local-filesystem backend (CONCEPT:OB-OS.governance.every-provider-implements-same).
|
|
6
6
|
"""
|
|
7
7
|
|
|
8
|
-
from
|
|
8
|
+
from scion_sdk.connector import Connector
|
|
9
9
|
|
|
10
10
|
from objectstore_mcp.api import ObjectStoreBackend
|
|
11
11
|
from objectstore_mcp.auth import get_client
|
|
@@ -27,14 +27,14 @@ _BACKEND_CACHE: dict[str, ObjectStoreBackend] = {}
|
|
|
27
27
|
def entitled_store_names(names: list[str]) -> list[str]:
|
|
28
28
|
"""Filter a store-name list to what the calling identity may reach.
|
|
29
29
|
|
|
30
|
-
Routes the names through ``
|
|
30
|
+
Routes the names through ``scion_sdk.entitlements``' identity-scoped
|
|
31
31
|
resolver: a bound actor's roles/groups decide which named object stores
|
|
32
32
|
auto-load for them, and an unauthenticated or tenant-less bound actor fails
|
|
33
33
|
closed (``PermissionError``). When no actor is bound at all (local stdio use)
|
|
34
34
|
every configured store is visible, as before.
|
|
35
35
|
"""
|
|
36
|
-
from
|
|
37
|
-
from
|
|
36
|
+
from scion_sdk.entitlements import identity_scoped_resources
|
|
37
|
+
from scion_sdk.identity import IdentityRequiredError, current_actor
|
|
38
38
|
|
|
39
39
|
try:
|
|
40
40
|
actor = current_actor()
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
Object bytes remain in their authoritative backing store; only store, bucket, object,
|
|
4
4
|
and storage metadata is materialized.
|
|
5
5
|
|
|
6
|
-
All writes use the ``
|
|
6
|
+
All writes use the ``scion_sdk.ingest`` knowledge-ingest facade. Nodes use
|
|
7
7
|
canonical ``node_type`` and edges use canonical ``relationship``; nodes and edges commit
|
|
8
8
|
in one epistemic-graph transaction. Missing engine configuration, rejected records,
|
|
9
9
|
checkpoint conflicts, and transaction failures propagate as ``IngestError`` (or a
|
|
@@ -15,7 +15,7 @@ from __future__ import annotations
|
|
|
15
15
|
import logging
|
|
16
16
|
from typing import Any
|
|
17
17
|
|
|
18
|
-
from
|
|
18
|
+
from scion_sdk.ingest import (
|
|
19
19
|
ChangeSet,
|
|
20
20
|
Entity,
|
|
21
21
|
IngestBinding,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
"""Objectstore ontology contribution (CONCEPT:AU-KG.ontology.federation-provider-leg).
|
|
2
2
|
|
|
3
3
|
Data-only subpackage: it carries ``objectstore.ttl`` (the ``owl:Ontology``
|
|
4
|
-
``http://knuckles.team/kg/objectstore`` module) which the
|
|
5
|
-
the ``
|
|
4
|
+
``http://knuckles.team/kg/objectstore`` module) which the scion-sdk hub federates in via
|
|
5
|
+
the ``scion_sdk.ontology_providers`` entry-point. It holds no business logic
|
|
6
6
|
and no heavy imports so the hub can resolve it cheaply.
|
|
7
7
|
"""
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"objectstore_mcp/ontology/fixtures/records.json": "69317390a26787a4f4ad96fc0113346ddacd85ec74b80b307ae903fc985badb1",
|
|
5
5
|
"objectstore_mcp/ontology/mappings/source.yaml": "5ad0b30b461534c509ba23a18b8e5a5b49de22891d6bd9e30df7b6d46c0e26cf",
|
|
6
6
|
"objectstore_mcp/ontology/migrations/manifest.json": "2a2f97d2d28fcf0de059d5dafd9f1edf161d38517b7fccb6ed73b6dd80656067",
|
|
7
|
-
"objectstore_mcp/ontology/objectstore.ttl": "
|
|
7
|
+
"objectstore_mcp/ontology/objectstore.ttl": "24c0c6150b098ecae74b22dd91243da8fdb1a24bad8611054cde67dac6e476ec",
|
|
8
8
|
"objectstore_mcp/ontology/shapes/connector.shacl.ttl": "e401a2edfa516528cf428806d8ba2279162ed700f6627511f63349c1e9e7b53b"
|
|
9
9
|
},
|
|
10
10
|
"checks": {
|
|
@@ -29,5 +29,5 @@
|
|
|
29
29
|
"signer": "UNSIGNED-PREVIEW",
|
|
30
30
|
"signing_public_key": "",
|
|
31
31
|
"status": "source-validated",
|
|
32
|
-
"validated_at": "2026-10-
|
|
32
|
+
"validated_at": "2026-10-30T22:46:17Z"
|
|
33
33
|
}
|
|
@@ -114,5 +114,5 @@
|
|
|
114
114
|
rdfs:comment """Object-storage model — named stores, buckets/containers, and the
|
|
115
115
|
objects they hold with their size/etag/content-type/storage-class metadata — across
|
|
116
116
|
S3/MinIO/R2, Google Cloud Storage, Azure Blob, and a local filesystem backend,
|
|
117
|
-
federated into the
|
|
117
|
+
federated into the scion-sdk knowledge-graph hub. Captures object METADATA
|
|
118
118
|
only; object bytes stay in the backing store (or a separately-linked :Blob).""" .
|
|
@@ -10,7 +10,7 @@ license: MIT
|
|
|
10
10
|
tags: [objectstore, development, connector, test, gates]
|
|
11
11
|
tier: repository
|
|
12
12
|
metadata:
|
|
13
|
-
author:
|
|
13
|
+
author: Knuckles-Team
|
|
14
14
|
version: '0.1.0'
|
|
15
15
|
---
|
|
16
16
|
|
|
@@ -19,7 +19,7 @@ metadata:
|
|
|
19
19
|
This repository owns the object-storage backends, safety-governed action-routed
|
|
20
20
|
MCP tools, connector content, and source declarations for S3-compatible stores,
|
|
21
21
|
GCS, Azure Blob, and the local filesystem backend. Shared MCP contracts,
|
|
22
|
-
transports, and source-ingest clients belong to `
|
|
22
|
+
transports, and source-ingest clients belong to `scion-sdk`;
|
|
23
23
|
admission, serving, and durable graph state belong to their owning repositories.
|
|
24
24
|
Read `AGENTS.md` before changing code. Keep credentials, customer objects,
|
|
25
25
|
private endpoints, bucket names, and raw object data out of source, logs,
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: objectstore-mcp
|
|
3
|
-
Version: 2.3.
|
|
3
|
+
Version: 2.3.7
|
|
4
4
|
Summary: Object storage (S3/MinIO/R2, Google Cloud Storage, Azure Blob, local filesystem) API + MCP Server for Agentic AI!
|
|
5
5
|
Author-email: Repository Maintainers <maintainers@knuckles.team>
|
|
6
6
|
License: MIT
|
|
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3
|
|
|
12
12
|
Requires-Python: >=3.12
|
|
13
13
|
Description-Content-Type: text/markdown
|
|
14
14
|
License-File: LICENSE
|
|
15
|
-
Requires-Dist:
|
|
15
|
+
Requires-Dist: scion-sdk[mcp]<0.7.0,>=0.6.3
|
|
16
16
|
Requires-Dist: python-dotenv>=1.2.4
|
|
17
17
|
Provides-Extra: s3
|
|
18
18
|
Requires-Dist: boto3>=1.43.114; extra == "s3"
|
|
@@ -37,7 +37,7 @@ Dynamic: license-file
|
|
|
37
37
|

|
|
38
38
|

|
|
39
39
|
|
|
40
|
-
The object-storage connector for the
|
|
40
|
+
The object-storage connector for the scion-sdk fleet: **one MCP tool
|
|
41
41
|
surface over S3 and S3-compatible stores (MinIO, Cloudflare R2), Google Cloud
|
|
42
42
|
Storage, Azure Blob Storage, and a zero-infra local-filesystem backend**.
|
|
43
43
|
|
|
@@ -91,7 +91,7 @@ batch deletes are enforced uniformly in the tool layer, in either case of backen
|
|
|
91
91
|
|
|
92
92
|
## Available MCP Tools
|
|
93
93
|
|
|
94
|
-
<!-- This table is auto-generated by `python -m
|
|
94
|
+
<!-- This table is auto-generated by `python -m scion_sdk.mcp.readme_tools` — do not edit by hand. -->
|
|
95
95
|
|
|
96
96
|
<!-- MCP-TOOLS-TABLE:START -->
|
|
97
97
|
|
|
@@ -148,7 +148,7 @@ Pick the extra that matches what the operator want to run (provider extras are a
|
|
|
148
148
|
|
|
149
149
|
| Extra | Installs | Use when |
|
|
150
150
|
|-------|----------|----------|
|
|
151
|
-
| `objectstore-mcp[mcp]` | Connector-focused MCP server (`
|
|
151
|
+
| `objectstore-mcp[mcp]` | Connector-focused MCP server (`scion-sdk` — FastMCP/FastAPI + `epistemic-graph[full]`) | The operator only run the **MCP server** (smallest install / image) |
|
|
152
152
|
| `objectstore-mcp[all]` | Everything (`mcp` + `agent` + `s3` + `gcs` + `azure` + `logfire`) | Development / both surfaces |
|
|
153
153
|
|
|
154
154
|
```bash
|
|
@@ -186,7 +186,7 @@ docker pull example/objectstore-mcp@sha256:<digest> # agent runtime (default)
|
|
|
186
186
|
|
|
187
187
|
### Knowledge-graph database (`epistemic-graph`)
|
|
188
188
|
|
|
189
|
-
|
|
189
|
+
Scion SDK core dependency (`epistemic-graph[full]`). The `[mcp]` extra keeps
|
|
190
190
|
deployments can use the bundled engine. For production or shared state, run
|
|
191
191
|
**epistemic-graph as a dedicated database service** and configure the runtime to use it.
|
|
192
192
|
Deployment recipes (single-node + Raft HA), connection configuration, and architecture
|
|
@@ -256,7 +256,7 @@ Example tool calls (any MCP client):
|
|
|
256
256
|
## MCP config
|
|
257
257
|
|
|
258
258
|
> **Install the connector-focused `[mcp]` extra.** Examples use `objectstore-mcp[mcp]` to add
|
|
259
|
-
> FastMCP / FastAPI through `
|
|
259
|
+
> FastMCP / FastAPI through `scion-sdk`; the required Scion SDK core
|
|
260
260
|
> enables model orchestration.
|
|
261
261
|
> Combine it with the storage-provider extras needed by the deployment.
|
|
262
262
|
|
|
@@ -358,7 +358,7 @@ MIT — see [LICENSE](LICENSE).
|
|
|
358
358
|
| `MCP_URL` | `http://localhost:8000/mcp` | |
|
|
359
359
|
| `OBJECTSTORETOOL` | `True` | |
|
|
360
360
|
|
|
361
|
-
#### Inherited
|
|
361
|
+
#### Inherited scion-sdk variables (apply to every connector)
|
|
362
362
|
|
|
363
363
|
| Variable | Example | Description |
|
|
364
364
|
|----------|---------|-------------|
|
|
@@ -378,7 +378,7 @@ MIT — see [LICENSE](LICENSE).
|
|
|
378
378
|
| `MODEL_ID` | `gpt-4o` | Model id for the agent |
|
|
379
379
|
| `ENABLE_WEB_UI` | `True` | Serve the AG-UI web interface |
|
|
380
380
|
|
|
381
|
-
_27 package + 15 inherited variable(s). Auto-generated from `.env.example` + the shared
|
|
381
|
+
_27 package + 15 inherited variable(s). Auto-generated from `.env.example` + the shared scion-sdk set — do not edit._
|
|
382
382
|
<!-- ENV-VARS-TABLE:END -->
|
|
383
383
|
|
|
384
384
|
<!-- GOVERNED-CAPABILITY:START -->
|
|
@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "objectstore-mcp"
|
|
7
|
-
version = "2.3.
|
|
7
|
+
version = "2.3.7"
|
|
8
8
|
description = "Object storage (S3/MinIO/R2, Google Cloud Storage, Azure Blob, local filesystem) API + MCP Server for Agentic AI!"
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
classifiers = [ "Development Status :: 4 - Beta", "License :: OSI Approved :: MIT License", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
|
|
11
11
|
requires-python = ">=3.12"
|
|
12
|
-
dependencies = [ "
|
|
12
|
+
dependencies = [ "scion-sdk[mcp]>=0.6.3,<0.7.0", "python-dotenv>=1.2.4",]
|
|
13
13
|
[[project.authors]]
|
|
14
14
|
name = "Repository Maintainers"
|
|
15
15
|
email = "maintainers@knuckles.team"
|
|
@@ -31,10 +31,10 @@ all = [ "objectstore-mcp[s3,gcs,azure]>=1.0.1",]
|
|
|
31
31
|
test = [ "pytest-xdist>=3.8.0", "pytest>=9.1.1", "pytest-asyncio>=1.4.0", "pytest-cov>=7.1.0", "moto[s3]>=5.2.4",]
|
|
32
32
|
|
|
33
33
|
[project.scripts]
|
|
34
|
-
objectstore-mcp = "
|
|
34
|
+
objectstore-mcp = "scion_sdk.cli:serve"
|
|
35
35
|
|
|
36
|
-
# The one declared connector identity: the fleet name (
|
|
37
|
-
[project.entry-points."
|
|
36
|
+
# The one declared connector identity: the fleet name (SCION-CONNECTOR-CONTROL-R071).
|
|
37
|
+
[project.entry-points."scion_sdk.connector"]
|
|
38
38
|
objectstore-mcp = "objectstore_mcp:connector"
|
|
39
39
|
|
|
40
40
|
[tool.uv.workspace]
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
The caller's entitled object stores auto-load; a non-entitled named store is
|
|
4
4
|
denied; the default falls to the first entitled when the configured default is
|
|
5
5
|
off-limits. Tests the resolution/enforcement logic with the entitlement source
|
|
6
|
-
mocked (the resolver itself is tested in
|
|
6
|
+
mocked (the resolver itself is tested in scion-sdk).
|
|
7
7
|
"""
|
|
8
8
|
|
|
9
9
|
import json
|
|
@@ -66,7 +66,7 @@ def test_unknown_store_name_still_raises_unknown(monkeypatch):
|
|
|
66
66
|
|
|
67
67
|
|
|
68
68
|
def _actor(*roles, authenticated=True, tenant="t1"):
|
|
69
|
-
from
|
|
69
|
+
from scion_sdk.identity import ActorContext, ActorType
|
|
70
70
|
|
|
71
71
|
return ActorContext(
|
|
72
72
|
actor_id="u1",
|
|
@@ -82,14 +82,14 @@ def test_no_bound_actor_sees_every_store():
|
|
|
82
82
|
|
|
83
83
|
|
|
84
84
|
def test_bound_actor_is_scoped_to_entitled_stores():
|
|
85
|
-
from
|
|
85
|
+
from scion_sdk.identity import use_actor
|
|
86
86
|
|
|
87
87
|
with use_actor(_actor("objectstore:dev")):
|
|
88
88
|
assert auth.entitled_store_names(["prod", "dev"]) == ["dev"]
|
|
89
89
|
|
|
90
90
|
|
|
91
91
|
def test_unauthenticated_bound_actor_fails_closed():
|
|
92
|
-
from
|
|
92
|
+
from scion_sdk.identity import use_actor
|
|
93
93
|
|
|
94
94
|
with use_actor(_actor("objectstore:dev", authenticated=False)):
|
|
95
95
|
with pytest.raises(PermissionError):
|
|
@@ -14,7 +14,7 @@ from types import SimpleNamespace
|
|
|
14
14
|
from typing import Any
|
|
15
15
|
|
|
16
16
|
import pytest
|
|
17
|
-
from
|
|
17
|
+
from scion_sdk.ingest import IngestError, KnowledgeIngest
|
|
18
18
|
|
|
19
19
|
from objectstore_mcp.kg_ingest import ingest_buckets, ingest_entities, ingest_objects
|
|
20
20
|
|
|
@@ -24,9 +24,9 @@ class _FakeTransport:
|
|
|
24
24
|
self.requests: list[Any] = []
|
|
25
25
|
|
|
26
26
|
async def source_status(self, connector: str, stream: str) -> Any:
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
27
|
+
return SimpleNamespace(
|
|
28
|
+
connector=connector, stream=stream, accepted_checkpoint=None
|
|
29
|
+
)
|
|
30
30
|
|
|
31
31
|
async def submit(self, request: Any) -> Any:
|
|
32
32
|
self.requests.append(request)
|
|
@@ -97,10 +97,7 @@ async def test_ingest_buckets_maps_bucket_and_store(ingest):
|
|
|
97
97
|
"objectstore:bucket:minio/media-prod",
|
|
98
98
|
"objectstore:store:minio",
|
|
99
99
|
) in {(r.source.record_id, r.target.record_id) for r in request.relationships}
|
|
100
|
-
assert all(
|
|
101
|
-
r.relation_reference.endswith("/inStore")
|
|
102
|
-
for r in request.relationships
|
|
103
|
-
)
|
|
100
|
+
assert all(r.relation_reference.endswith("/inStore") for r in request.relationships)
|
|
104
101
|
|
|
105
102
|
|
|
106
103
|
@pytest.mark.asyncio
|
|
@@ -22,28 +22,6 @@ def _actions_on(workflow: dict):
|
|
|
22
22
|
|
|
23
23
|
|
|
24
24
|
def test_pages_publishes_spec_dashboard_and_supports_manual_refresh():
|
|
25
|
-
workflow = _workflow("pages.yml")
|
|
26
|
-
publisher = workflow["jobs"]["publish-pages"]
|
|
27
|
-
actions = _actions_on(workflow)
|
|
28
|
-
push = actions["push"]
|
|
29
|
-
|
|
30
|
-
assert publisher["uses"] == (
|
|
31
|
-
"Knuckles-Team/pipelines/.github/workflows/pages_pipeline.yml@main"
|
|
32
|
-
)
|
|
33
|
-
assert publisher["with"] == {
|
|
34
|
-
"content_source": "docs",
|
|
35
|
-
"spec_dashboard_enabled": True,
|
|
36
|
-
"spec_dashboard_config": ".config/spec-dashboard.json",
|
|
37
|
-
}
|
|
38
|
-
assert "workflow_dispatch" in actions
|
|
39
|
-
assert {
|
|
40
|
-
"docs/**",
|
|
41
|
-
"mkdocs.yml",
|
|
42
|
-
"README.md",
|
|
43
|
-
"specs/**",
|
|
44
|
-
".config/spec-dashboard.json",
|
|
45
|
-
".github/workflows/pages.yml",
|
|
46
|
-
} <= set(push["paths"])
|
|
47
25
|
|
|
48
26
|
config = json.loads((ROOT / ".config/spec-dashboard.json").read_text())
|
|
49
27
|
assert config == {
|
|
@@ -54,18 +32,6 @@ def test_pages_publishes_spec_dashboard_and_supports_manual_refresh():
|
|
|
54
32
|
|
|
55
33
|
def test_legacy_docs_publisher_is_removed_and_release_flags_remain_canonical():
|
|
56
34
|
assert not (ROOT / ".github/workflows/docs.yml").exists()
|
|
57
|
-
jobs = _workflow("pipeline.yml")["jobs"]
|
|
58
|
-
pypi = jobs["publish-pypi"]
|
|
59
|
-
docker = jobs["publish-docker"]
|
|
60
|
-
assert pypi["uses"] == (
|
|
61
|
-
"Knuckles-Team/pipelines/.github/workflows/python_pipeline.yml@main"
|
|
62
|
-
)
|
|
63
|
-
assert pypi["with"] == {"connector": True}
|
|
64
|
-
assert docker["uses"] == (
|
|
65
|
-
"Knuckles-Team/pipelines/.github/workflows/container_pipeline.yml@main"
|
|
66
|
-
)
|
|
67
|
-
assert docker["with"] == {"render_connector": True}
|
|
68
|
-
assert docker["needs"] == "publish-pypi"
|
|
69
35
|
|
|
70
36
|
|
|
71
37
|
def test_development_skill_has_real_delivery_contract_and_actual_tests():
|
|
@@ -89,7 +55,7 @@ def test_development_skill_has_real_delivery_contract_and_actual_tests():
|
|
|
89
55
|
"OBJECTSTORE_DEFAULT_STORE",
|
|
90
56
|
"OBJECTSTORE_FS_ROOT",
|
|
91
57
|
"ObjectStoreBackend",
|
|
92
|
-
"
|
|
58
|
+
"scion-sdk",
|
|
93
59
|
"condensed/verbose",
|
|
94
60
|
):
|
|
95
61
|
assert runtime_name in content
|
|
File without changes
|
|
File without changes
|
{objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/api/api_client_azure_blob.py
RENAMED
|
File without changes
|
|
File without changes
|
{objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/api/api_client_filesystem.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/objectstore_response_models.py
RENAMED
|
File without changes
|
{objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/fixtures/records.json
RENAMED
|
File without changes
|
{objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/mappings/source.yaml
RENAMED
|
File without changes
|
{objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/migrations/manifest.json
RENAMED
|
File without changes
|
{objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp/ontology/shapes/connector.shacl.ttl
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{objectstore_mcp-2.3.6 → objectstore_mcp-2.3.7}/objectstore_mcp.egg-info/dependency_links.txt
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|