scholarx 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.
- {scholarx-2.3.6/scholarx.egg-info → scholarx-2.3.7}/PKG-INFO +9 -9
- {scholarx-2.3.6 → scholarx-2.3.7}/README.md +6 -6
- {scholarx-2.3.6 → scholarx-2.3.7}/pyproject.toml +7 -13
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/__init__.py +39 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/cli.py +4 -3
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/connector_sources.py +1 -19
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/kg_ingest.py +4 -4
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/kg_media.py +2 -2
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/mcp_server.py +10 -68
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/ontology/__init__.py +2 -2
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/ontology/certification.json +2 -2
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/ontology/scholarx.ttl +1 -1
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/paper_storage.py +3 -3
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-development/SKILL.md +2 -2
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-kg-ingestion/SKILL.md +1 -1
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-paper-library/SKILL.md +1 -1
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-paper-search/SKILL.md +1 -1
- {scholarx-2.3.6 → scholarx-2.3.7/scholarx.egg-info}/PKG-INFO +9 -9
- scholarx-2.3.7/scholarx.egg-info/entry_points.txt +6 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx.egg-info/requires.txt +2 -2
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_action_discovery.py +1 -1
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_default_content_surfaces.py +3 -7
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_kg_ingest.py +2 -2
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_kg_media.py +2 -2
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_mcp_server.py +15 -36
- scholarx-2.3.6/scholarx.egg-info/entry_points.txt +0 -12
- {scholarx-2.3.6 → scholarx-2.3.7}/LICENSE +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/__main__.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/api_client.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/connectors/__init__.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/deduplication.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/mcp_config.json +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/models.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/ontology/fixtures/records.json +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/ontology/mappings/source.yaml +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/ontology/migrations/manifest.json +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/ontology/shapes/connector.shacl.ttl +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/prompts/__init__.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/providers/__init__.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/providers/arxiv.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/providers/base.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/providers/biorxiv.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/providers/osf.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/providers/pmc.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/providers/rss.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/providers/semantic_scholar.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/queue.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/__init__.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-kg-ingestion/WORKFLOW.md +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-operations/SKILL.md +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-operations/agents/openai.yaml +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-operations/references/catalog.md +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-paper-library/WORKFLOW.md +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx/skills/scholarx-paper-search/WORKFLOW.md +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx.egg-info/SOURCES.txt +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx.egg-info/dependency_links.txt +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/scholarx.egg-info/top_level.txt +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/setup.cfg +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_cli.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_cli_extended.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_init_dynamics.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_models.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_operation_tools.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_paper_storage.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_parallel_download.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_providers.py +0 -0
- {scholarx-2.3.6 → scholarx-2.3.7}/tests/test_queue.py +0 -0
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: scholarx
|
|
3
|
-
Version: 2.3.
|
|
3
|
+
Version: 2.3.7
|
|
4
4
|
Summary: Universal Research Paper API — single entry point for arXiv, PMC, bioRxiv, medRxiv, PsyArXiv, OSF, and Semantic Scholar
|
|
5
5
|
Author-email: Repository Maintainers <maintainers@knuckles.team>
|
|
6
6
|
License: MIT
|
|
7
7
|
Requires-Python: <3.15,>=3.12
|
|
8
8
|
Description-Content-Type: text/markdown
|
|
9
9
|
License-File: LICENSE
|
|
10
|
-
Requires-Dist:
|
|
10
|
+
Requires-Dist: scion-sdk[mcp]<0.7.0,>=0.6.3
|
|
11
11
|
Requires-Dist: httpx>=0.28.1
|
|
12
12
|
Requires-Dist: python-dotenv>=1.2.4
|
|
13
13
|
Requires-Dist: Levenshtein>=0.27.5
|
|
@@ -15,7 +15,7 @@ Requires-Dist: pypdf>=6.21.0
|
|
|
15
15
|
Requires-Dist: rich>=15.0.0
|
|
16
16
|
Requires-Dist: defusedxml>=0.7.1
|
|
17
17
|
Provides-Extra: mcp
|
|
18
|
-
Requires-Dist:
|
|
18
|
+
Requires-Dist: scion-sdk[mcp]<0.7.0,>=0.6.3; extra == "mcp"
|
|
19
19
|
Provides-Extra: all
|
|
20
20
|
Requires-Dist: scholarx[mcp]; extra == "all"
|
|
21
21
|
Provides-Extra: test
|
|
@@ -151,7 +151,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
|
|
|
151
151
|
<!-- MCP-CONFIG-EXAMPLES:START -->
|
|
152
152
|
|
|
153
153
|
> **Install the connector-focused `[mcp]` extra.** Examples use `scholarx[mcp]` to add
|
|
154
|
-
> FastMCP / FastAPI through `
|
|
154
|
+
> FastMCP / FastAPI through `scion-sdk`; the required Scion SDK core
|
|
155
155
|
> still carries `epistemic-graph[full]`. The `[agent-runtime]` extra additionally
|
|
156
156
|
> enables model orchestration.
|
|
157
157
|
|
|
@@ -369,7 +369,7 @@ Detailed graph node architecture explanations, custom skill configurations, and
|
|
|
369
369
|
|
|
370
370
|
## Security & Governance
|
|
371
371
|
|
|
372
|
-
Built directly upon the enterprise-ready [`
|
|
372
|
+
Built directly upon the enterprise-ready [`scion-sdk`](https://github.com/Knuckles-Team/scion-sdk) core, standard security parameters are fully supported:
|
|
373
373
|
|
|
374
374
|
### Access Control & Policy Enforcement
|
|
375
375
|
- **Eunomia Policies:** Fine-grained, policy-driven tool authorization. Supports `none`, local `embedded` (`mcp_policies.json`), or centralized `remote` modes.
|
|
@@ -415,7 +415,7 @@ Built directly upon the enterprise-ready [`agent-connector-sdk`](https://github.
|
|
|
415
415
|
| `DISCOVERYTOOL` | `True` | |
|
|
416
416
|
| `STORAGETOOL` | `True` | |
|
|
417
417
|
|
|
418
|
-
#### Inherited
|
|
418
|
+
#### Inherited scion-sdk variables (apply to every connector)
|
|
419
419
|
|
|
420
420
|
| Variable | Example | Description |
|
|
421
421
|
|----------|---------|-------------|
|
|
@@ -434,7 +434,7 @@ Built directly upon the enterprise-ready [`agent-connector-sdk`](https://github.
|
|
|
434
434
|
| `MODEL_ID` | `gpt-4o` | Model id for the agent |
|
|
435
435
|
| `ENABLE_WEB_UI` | `True` | Serve the AG-UI web interface |
|
|
436
436
|
|
|
437
|
-
_21 package + 14 inherited variable(s). Auto-generated from `.env.example` + the shared
|
|
437
|
+
_21 package + 14 inherited variable(s). Auto-generated from `.env.example` + the shared scion-sdk set — do not edit._
|
|
438
438
|
<!-- ENV-VARS-TABLE:END -->
|
|
439
439
|
|
|
440
440
|
|
|
@@ -472,7 +472,7 @@ Pick the extra that matches what the operator want to run:
|
|
|
472
472
|
|
|
473
473
|
| Extra | Installs | Use when |
|
|
474
474
|
|-------|----------|----------|
|
|
475
|
-
| `scholarx[mcp]` | Connector-focused MCP server (`
|
|
475
|
+
| `scholarx[mcp]` | Connector-focused MCP server (`scion-sdk` — FastMCP/FastAPI + `epistemic-graph[full]`) | The operator only run the **MCP server** (smallest install / image) |
|
|
476
476
|
| `scholarx[all]` | Everything (`mcp` + `agent`) | Development / both surfaces |
|
|
477
477
|
|
|
478
478
|
```bash
|
|
@@ -501,7 +501,7 @@ agent (`immutable agent digest`) with a co-located `:mcp` sidecar.
|
|
|
501
501
|
|
|
502
502
|
### Knowledge-graph database (`epistemic-graph`)
|
|
503
503
|
|
|
504
|
-
|
|
504
|
+
Scion SDK core dependency (`epistemic-graph[full]`). The `[mcp]` extra keeps
|
|
505
505
|
deployments can use the bundled engine. For production or shared state, run
|
|
506
506
|
**epistemic-graph as a dedicated database service** and configure the runtime to use it.
|
|
507
507
|
Deployment recipes (single-node + Raft HA), connection configuration, and architecture
|
|
@@ -123,7 +123,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
|
|
|
123
123
|
<!-- MCP-CONFIG-EXAMPLES:START -->
|
|
124
124
|
|
|
125
125
|
> **Install the connector-focused `[mcp]` extra.** Examples use `scholarx[mcp]` to add
|
|
126
|
-
> FastMCP / FastAPI through `
|
|
126
|
+
> FastMCP / FastAPI through `scion-sdk`; the required Scion SDK core
|
|
127
127
|
> still carries `epistemic-graph[full]`. The `[agent-runtime]` extra additionally
|
|
128
128
|
> enables model orchestration.
|
|
129
129
|
|
|
@@ -341,7 +341,7 @@ Detailed graph node architecture explanations, custom skill configurations, and
|
|
|
341
341
|
|
|
342
342
|
## Security & Governance
|
|
343
343
|
|
|
344
|
-
Built directly upon the enterprise-ready [`
|
|
344
|
+
Built directly upon the enterprise-ready [`scion-sdk`](https://github.com/Knuckles-Team/scion-sdk) core, standard security parameters are fully supported:
|
|
345
345
|
|
|
346
346
|
### Access Control & Policy Enforcement
|
|
347
347
|
- **Eunomia Policies:** Fine-grained, policy-driven tool authorization. Supports `none`, local `embedded` (`mcp_policies.json`), or centralized `remote` modes.
|
|
@@ -387,7 +387,7 @@ Built directly upon the enterprise-ready [`agent-connector-sdk`](https://github.
|
|
|
387
387
|
| `DISCOVERYTOOL` | `True` | |
|
|
388
388
|
| `STORAGETOOL` | `True` | |
|
|
389
389
|
|
|
390
|
-
#### Inherited
|
|
390
|
+
#### Inherited scion-sdk variables (apply to every connector)
|
|
391
391
|
|
|
392
392
|
| Variable | Example | Description |
|
|
393
393
|
|----------|---------|-------------|
|
|
@@ -406,7 +406,7 @@ Built directly upon the enterprise-ready [`agent-connector-sdk`](https://github.
|
|
|
406
406
|
| `MODEL_ID` | `gpt-4o` | Model id for the agent |
|
|
407
407
|
| `ENABLE_WEB_UI` | `True` | Serve the AG-UI web interface |
|
|
408
408
|
|
|
409
|
-
_21 package + 14 inherited variable(s). Auto-generated from `.env.example` + the shared
|
|
409
|
+
_21 package + 14 inherited variable(s). Auto-generated from `.env.example` + the shared scion-sdk set — do not edit._
|
|
410
410
|
<!-- ENV-VARS-TABLE:END -->
|
|
411
411
|
|
|
412
412
|
|
|
@@ -444,7 +444,7 @@ Pick the extra that matches what the operator want to run:
|
|
|
444
444
|
|
|
445
445
|
| Extra | Installs | Use when |
|
|
446
446
|
|-------|----------|----------|
|
|
447
|
-
| `scholarx[mcp]` | Connector-focused MCP server (`
|
|
447
|
+
| `scholarx[mcp]` | Connector-focused MCP server (`scion-sdk` — FastMCP/FastAPI + `epistemic-graph[full]`) | The operator only run the **MCP server** (smallest install / image) |
|
|
448
448
|
| `scholarx[all]` | Everything (`mcp` + `agent`) | Development / both surfaces |
|
|
449
449
|
|
|
450
450
|
```bash
|
|
@@ -473,7 +473,7 @@ agent (`immutable agent digest`) with a co-located `:mcp` sidecar.
|
|
|
473
473
|
|
|
474
474
|
### Knowledge-graph database (`epistemic-graph`)
|
|
475
475
|
|
|
476
|
-
|
|
476
|
+
Scion SDK core dependency (`epistemic-graph[full]`). The `[mcp]` extra keeps
|
|
477
477
|
deployments can use the bundled engine. For production or shared state, run
|
|
478
478
|
**epistemic-graph as a dedicated database service** and configure the runtime to use it.
|
|
479
479
|
Deployment recipes (single-node + Raft HA), connection configuration, and architecture
|
|
@@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "scholarx"
|
|
7
|
-
version = "2.3.
|
|
7
|
+
version = "2.3.7"
|
|
8
8
|
description = "Universal Research Paper API — single entry point for arXiv, PMC, bioRxiv, medRxiv, PsyArXiv, OSF, and Semantic Scholar"
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
license = { text = "MIT" }
|
|
11
11
|
requires-python = ">=3.12, <3.15"
|
|
12
12
|
authors = [{ name = "Repository Maintainers", email = "maintainers@knuckles.team" }]
|
|
13
13
|
dependencies = [
|
|
14
|
-
"
|
|
14
|
+
"scion-sdk[mcp]>=0.6.3,<0.7.0",
|
|
15
15
|
"httpx>=0.28.1",
|
|
16
16
|
"python-dotenv>=1.2.4",
|
|
17
17
|
"Levenshtein>=0.27.5",
|
|
@@ -21,24 +21,18 @@ dependencies = [
|
|
|
21
21
|
]
|
|
22
22
|
|
|
23
23
|
[project.optional-dependencies]
|
|
24
|
-
mcp = ["
|
|
24
|
+
mcp = ["scion-sdk[mcp]>=0.6.3,<0.7.0"]
|
|
25
25
|
all = ["scholarx[mcp]"]
|
|
26
26
|
test = [
|
|
27
27
|
"pytest-xdist>=3.8.0","pytest>=9.1.1", "pytest-asyncio>=1.4.0", "pytest-cov>=7.1.0", "respx>=0.23.1"]
|
|
28
28
|
|
|
29
29
|
[project.scripts]
|
|
30
30
|
scholarx = "scholarx.cli:cli"
|
|
31
|
-
scholarx-mcp = "
|
|
31
|
+
scholarx-mcp = "scion_sdk.cli:serve"
|
|
32
32
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
[project.entry-points."agent_connector_sdk.ontology_providers"]
|
|
37
|
-
scholarx = "scholarx.ontology"
|
|
38
|
-
|
|
39
|
-
# The one declared connector identity: the fleet name (SDK-CONNECTOR-CONTROL-R071).
|
|
40
|
-
[project.entry-points."agent_connector_sdk.connector"]
|
|
41
|
-
scholarx-mcp = "scholarx"
|
|
33
|
+
# The one declared connector identity: the fleet name (SCION-CONNECTOR-CONTROL-R071).
|
|
34
|
+
[project.entry-points."scion_sdk.connector"]
|
|
35
|
+
scholarx-mcp = "scholarx:connector"
|
|
42
36
|
|
|
43
37
|
[tool.uv.workspace]
|
|
44
38
|
members = ["."]
|
|
@@ -81,3 +81,42 @@ def __getattr__(name: str) -> Any:
|
|
|
81
81
|
|
|
82
82
|
def __dir__() -> list[str]:
|
|
83
83
|
return sorted(list(globals().keys()) + __all__)
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
def _declare_connector():
|
|
87
|
+
"""Build the declared connector (SDK-owned server bootstrap)."""
|
|
88
|
+
from scion_sdk.connector import Connector
|
|
89
|
+
|
|
90
|
+
from scholarx.api_client import ScholarXClient
|
|
91
|
+
from scholarx.mcp_server import (
|
|
92
|
+
_get_client,
|
|
93
|
+
register_discovery_tools,
|
|
94
|
+
register_kg_tools,
|
|
95
|
+
register_operation_tools,
|
|
96
|
+
register_prompt_surface,
|
|
97
|
+
register_search_tools,
|
|
98
|
+
register_storage_tools,
|
|
99
|
+
)
|
|
100
|
+
|
|
101
|
+
return Connector(
|
|
102
|
+
api=ScholarXClient,
|
|
103
|
+
get_client=_get_client,
|
|
104
|
+
instructions=(
|
|
105
|
+
"Universal research paper search and analysis across arXiv, PMC, "
|
|
106
|
+
"bioRxiv, medRxiv, PsyArXiv, OSF, and Semantic Scholar. "
|
|
107
|
+
"Use search tools to find papers, discovery tools to explore "
|
|
108
|
+
"recent publications, and storage tools to download full PDFs."
|
|
109
|
+
),
|
|
110
|
+
tool_registry=(
|
|
111
|
+
("search", "SEARCHTOOL", register_search_tools),
|
|
112
|
+
("discovery", "DISCOVERYTOOL", register_discovery_tools),
|
|
113
|
+
("storage", "STORAGETOOL", register_storage_tools),
|
|
114
|
+
("operation", "OPERATIONTOOL", register_operation_tools),
|
|
115
|
+
("kg", "KGTOOL", register_kg_tools),
|
|
116
|
+
),
|
|
117
|
+
extra_registrations=(register_prompt_surface,),
|
|
118
|
+
)
|
|
119
|
+
|
|
120
|
+
|
|
121
|
+
connector = _declare_connector()
|
|
122
|
+
__all__.append("connector")
|
|
@@ -21,6 +21,7 @@ import sys
|
|
|
21
21
|
from collections import defaultdict
|
|
22
22
|
from dataclasses import dataclass, field
|
|
23
23
|
from datetime import UTC, datetime
|
|
24
|
+
from importlib.metadata import version as _distribution_version
|
|
24
25
|
from pathlib import Path
|
|
25
26
|
from typing import Any
|
|
26
27
|
|
|
@@ -39,7 +40,7 @@ from rich.table import Table
|
|
|
39
40
|
|
|
40
41
|
console = Console()
|
|
41
42
|
|
|
42
|
-
|
|
43
|
+
_VERSION = _distribution_version("scholarx")
|
|
43
44
|
|
|
44
45
|
# ── Default Relevance Taxonomy ──────────────────────────────────────────────
|
|
45
46
|
|
|
@@ -364,7 +365,7 @@ def _load_scan_taxonomy(args: argparse.Namespace) -> dict[str, Any]:
|
|
|
364
365
|
def _print_scan_header(args: argparse.Namespace, categories: list[str], output_dir: Path) -> None:
|
|
365
366
|
console.print(
|
|
366
367
|
Panel.fit(
|
|
367
|
-
f"[bold cyan]ScholarX Research Scanner v{
|
|
368
|
+
f"[bold cyan]ScholarX Research Scanner v{_VERSION}[/bold cyan]\n"
|
|
368
369
|
f"Query: [green]{args.query}[/green]\n"
|
|
369
370
|
f"Categories: [yellow]{', '.join(categories)}[/yellow]\n"
|
|
370
371
|
f"Max results: [blue]{args.max_results}[/blue]\n"
|
|
@@ -851,7 +852,7 @@ def _resolve_analysis_targets(args: argparse.Namespace, packages_root: Path) ->
|
|
|
851
852
|
else:
|
|
852
853
|
agents_root = packages_root
|
|
853
854
|
targets = [
|
|
854
|
-
agents_root / "
|
|
855
|
+
agents_root / "scion-sdk",
|
|
855
856
|
agents_root / "agents" / "scholarx",
|
|
856
857
|
]
|
|
857
858
|
for sub in ["agent-terminal-ui", "agent-webui"]:
|
|
@@ -6,8 +6,7 @@ Served live as ``connector://resources``. Regenerate by editing the declarations
|
|
|
6
6
|
# ruff: noqa: E501
|
|
7
7
|
from __future__ import annotations
|
|
8
8
|
|
|
9
|
-
from
|
|
10
|
-
from agent_connector_sdk.ingest.sources import IngestSourceDeclaration, IngestSourceSpec
|
|
9
|
+
from scion_sdk.ingest.live_declaration import source_meta
|
|
11
10
|
|
|
12
11
|
CONNECTOR = "scholarx-mcp"
|
|
13
12
|
|
|
@@ -82,20 +81,3 @@ RESOURCES = (
|
|
|
82
81
|
"name": "ResearchCategory",
|
|
83
82
|
},
|
|
84
83
|
)
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
def declaration() -> IngestSourceDeclaration:
|
|
88
|
-
"""The declaration the server assembles from this module."""
|
|
89
|
-
specs = []
|
|
90
|
-
for item in SOURCES:
|
|
91
|
-
for entry in item["connector_sources"]:
|
|
92
|
-
body = {k: v for k, v in entry.items() if k not in ("tool", "mapping")}
|
|
93
|
-
specs.append(IngestSourceSpec.model_validate({**body, "tools": (entry["tool"],)}))
|
|
94
|
-
return IngestSourceDeclaration.model_validate(
|
|
95
|
-
{
|
|
96
|
-
"connector": CONNECTOR,
|
|
97
|
-
"sources": specs,
|
|
98
|
-
"schema_mappings": SCHEMA_MAPPINGS,
|
|
99
|
-
"resources": RESOURCES,
|
|
100
|
-
}
|
|
101
|
-
)
|
|
@@ -7,9 +7,9 @@ fetches into the ONE epistemic-graph knowledge graph as **typed OWL nodes** (``:
|
|
|
7
7
|
its abstract as searchable ``text`` — as the **document** modality in the same node. Raw PDF
|
|
8
8
|
bytes ride the **blob** path in :mod:`scholarx.kg_media`.
|
|
9
9
|
|
|
10
|
-
The write path is the SDK's knowledge-ingest facade (:mod:`
|
|
10
|
+
The write path is the SDK's knowledge-ingest facade (:mod:`scion_sdk.ingest`), which
|
|
11
11
|
submits a typed ``ChangeSet`` through the generated epistemic-graph ``SourceIngest`` request/
|
|
12
|
-
receipt types. Engine failures are explicit (:class:`~
|
|
12
|
+
receipt types. Engine failures are explicit (:class:`~scion_sdk.ingest.IngestError`)
|
|
13
13
|
and partial writes are never acknowledged. Node ids follow ``scholarx:<class>:<externalId>``
|
|
14
14
|
and ``node_type`` matches the classes federated by ``scholarx.ontology``.
|
|
15
15
|
"""
|
|
@@ -20,7 +20,7 @@ import logging
|
|
|
20
20
|
import re
|
|
21
21
|
from typing import Any
|
|
22
22
|
|
|
23
|
-
from
|
|
23
|
+
from scion_sdk.ingest import (
|
|
24
24
|
ChangeSet,
|
|
25
25
|
Document,
|
|
26
26
|
Entity,
|
|
@@ -229,7 +229,7 @@ async def ingest_papers(
|
|
|
229
229
|
"""Map ScholarX papers → typed nodes and ingest them in one txn.
|
|
230
230
|
|
|
231
231
|
Best-effort: returns ``{"nodes":n, "edges":m}`` or ``None`` (nothing to write).
|
|
232
|
-
Raises :class:`~
|
|
232
|
+
Raises :class:`~scion_sdk.ingest.IngestError` on an engine failure — callers
|
|
233
233
|
that need "never raises" semantics (e.g. an auto-ingest hook on the search path) should
|
|
234
234
|
catch it themselves, same as before.
|
|
235
235
|
"""
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
CONCEPT:AU-KG.ingest.list-durable-media. When a live epistemic-graph engine is reachable, a
|
|
4
4
|
downloaded paper PDF is stored as a content-addressed **blob** with a ``:MediaAsset`` graph
|
|
5
5
|
node (carrying the paper's metadata) via the SDK's knowledge-ingest facade
|
|
6
|
-
(:mod:`
|
|
6
|
+
(:mod:`scion_sdk.ingest`) — the same ``ChangeSet.media`` path every connector's blob
|
|
7
7
|
ingestion goes through. This makes the raw PDF bytes — not just a filesystem path — durable,
|
|
8
8
|
deduped, and queryable inside the knowledge graph, and lets the twin :mod:`scholarx.kg_ingest`
|
|
9
9
|
typed ``:Paper`` node point at it via ``:hasFullText``.
|
|
@@ -19,7 +19,7 @@ import logging
|
|
|
19
19
|
import os
|
|
20
20
|
from typing import Any
|
|
21
21
|
|
|
22
|
-
from
|
|
22
|
+
from scion_sdk.ingest import (
|
|
23
23
|
ChangeSet,
|
|
24
24
|
IngestBinding,
|
|
25
25
|
IngestError,
|
|
@@ -2,26 +2,21 @@
|
|
|
2
2
|
"""ScholarX MCP Server.
|
|
3
3
|
|
|
4
4
|
Thin MCP wrapper over the ScholarX API client. Provides search, discovery,
|
|
5
|
-
and storage tools via the standard
|
|
5
|
+
and storage tools via the standard scion-sdk MCP server factory.
|
|
6
6
|
"""
|
|
7
7
|
|
|
8
8
|
import asyncio
|
|
9
9
|
import logging
|
|
10
|
-
import sys
|
|
11
10
|
from dataclasses import dataclass
|
|
12
|
-
from importlib.metadata import version as _distribution_version
|
|
13
11
|
|
|
14
|
-
from agent_connector_sdk.config import load_config, setting
|
|
15
|
-
from agent_connector_sdk.mcp.action_dispatch import resolve_action
|
|
16
|
-
from agent_connector_sdk.mcp.concurrency import run_blocking
|
|
17
|
-
from agent_connector_sdk.mcp.tool_surface import register_tool_surface
|
|
18
12
|
from fastmcp import Context
|
|
19
13
|
from pydantic import Field
|
|
14
|
+
from scion_sdk.config import load_config
|
|
15
|
+
from scion_sdk.mcp.action_dispatch import resolve_action
|
|
16
|
+
from scion_sdk.mcp.concurrency import run_blocking
|
|
20
17
|
|
|
21
18
|
load_config()
|
|
22
19
|
|
|
23
|
-
__version__ = _distribution_version("scholarx")
|
|
24
|
-
|
|
25
20
|
# Wall budget for an inline single-paper download before it is handed to the
|
|
26
21
|
# background queue. Kept well under the MCP child-call timeout so a slow source
|
|
27
22
|
# can never hold the (serialized) server slot open and wedge subsequent calls.
|
|
@@ -604,11 +599,11 @@ def register_prompts(mcp):
|
|
|
604
599
|
"""Register analysis prompts for the genius-agent."""
|
|
605
600
|
|
|
606
601
|
@mcp.prompt()
|
|
607
|
-
def
|
|
608
|
-
"""Scan recent CS/AI papers for
|
|
602
|
+
def scion_sdk_enhancement_scan() -> str:
|
|
603
|
+
"""Scan recent CS/AI papers for scion-sdk enhancement opportunities."""
|
|
609
604
|
return (
|
|
610
605
|
"Search for recent papers in cs.AI, cs.MA, cs.SE, cs.LG, cs.CL.\n"
|
|
611
|
-
"For each paper, evaluate against
|
|
606
|
+
"For each paper, evaluate against scion-sdk concepts (AU-001 through AU-047):\n"
|
|
612
607
|
"1. Primary contribution type (theoretical/empirical/artifact/methodology)\n"
|
|
613
608
|
"2. Gap addressed relative to existing AU concepts\n"
|
|
614
609
|
"3. Theoretical relationship (extends/contradicts/complements)\n"
|
|
@@ -632,59 +627,6 @@ def register_prompts(mcp):
|
|
|
632
627
|
)
|
|
633
628
|
|
|
634
629
|
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
def get_mcp_instance():
|
|
639
|
-
"""Create and configure the MCP server instance."""
|
|
640
|
-
from agent_connector_sdk.mcp.server import create_mcp_server
|
|
641
|
-
|
|
642
|
-
args, mcp, middlewares = create_mcp_server(
|
|
643
|
-
name="ScholarX MCP",
|
|
644
|
-
version=__version__,
|
|
645
|
-
instructions=(
|
|
646
|
-
"Universal research paper search and analysis across arXiv, PMC, "
|
|
647
|
-
"bioRxiv, medRxiv, PsyArXiv, OSF, and Semantic Scholar. "
|
|
648
|
-
"Use search tools to find papers, discovery tools to explore "
|
|
649
|
-
"recent publications, and storage tools to download full PDFs."
|
|
650
|
-
),
|
|
651
|
-
)
|
|
652
|
-
|
|
653
|
-
from scholarx.api_client import ScholarXClient
|
|
654
|
-
|
|
655
|
-
register_tool_surface(
|
|
656
|
-
mcp,
|
|
657
|
-
client_cls=ScholarXClient,
|
|
658
|
-
get_client=_get_client,
|
|
659
|
-
service="scholarx",
|
|
660
|
-
registrars=[
|
|
661
|
-
register_search_tools,
|
|
662
|
-
register_discovery_tools,
|
|
663
|
-
register_storage_tools,
|
|
664
|
-
register_operation_tools,
|
|
665
|
-
register_kg_tools,
|
|
666
|
-
],
|
|
667
|
-
)
|
|
668
|
-
|
|
669
|
-
register_prompts(mcp)
|
|
670
|
-
|
|
671
|
-
return args, mcp
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
def mcp_server():
|
|
675
|
-
"""MCP server entry point."""
|
|
676
|
-
print(f"ScholarX MCP v{__version__}", file=sys.stderr)
|
|
677
|
-
args, mcp = get_mcp_instance()
|
|
678
|
-
|
|
679
|
-
transport = getattr(args, "transport", setting("TRANSPORT", "stdio"))
|
|
680
|
-
host = getattr(args, "host", setting("HOST", "127.0.0.1"))
|
|
681
|
-
port = int(getattr(args, "port", setting("PORT", "9600")))
|
|
682
|
-
|
|
683
|
-
if transport == "stdio":
|
|
684
|
-
mcp.run(transport="stdio")
|
|
685
|
-
else:
|
|
686
|
-
mcp.run(transport="streamable-http", host=host, port=port)
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
if __name__ == "__main__":
|
|
690
|
-
mcp_server()
|
|
630
|
+
def register_prompt_surface(context):
|
|
631
|
+
"""Registration hook: serve the analysis prompts on the connector's server."""
|
|
632
|
+
register_prompts(context.server)
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
"""Scholarx ontology contribution (CONCEPT:AU-KG.ontology.federation-provider-leg).
|
|
2
2
|
|
|
3
3
|
Data-only subpackage: it carries ``scholarx.ttl`` (the ``owl:Ontology``
|
|
4
|
-
``http://knuckles.team/kg/scholarx`` module) which the
|
|
5
|
-
the ``
|
|
4
|
+
``http://knuckles.team/kg/scholarx`` 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
|
"scholarx/ontology/fixtures/records.json": "b0388efa7f3896eb816a9dd6ff681177e35e08f8cef1b36b50574b539e7c7500",
|
|
5
5
|
"scholarx/ontology/mappings/source.yaml": "18a3036f8139108be4ceefab417c04e7232d0f532bad4cbdf392c503664598dc",
|
|
6
6
|
"scholarx/ontology/migrations/manifest.json": "bfeda48a1409171c681c100c996615d1710e6a56235d52e0e99572d75d1aa892",
|
|
7
|
-
"scholarx/ontology/scholarx.ttl": "
|
|
7
|
+
"scholarx/ontology/scholarx.ttl": "177e0e8fa217ec27a497a4fb559d89b65eaca5cc522e217d5f26a818e34c1345",
|
|
8
8
|
"scholarx/ontology/shapes/connector.shacl.ttl": "2e223e425a72b24e2227f98f0692baf22c0476ae073febb05e4d5fc7e75be438"
|
|
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:55:14Z"
|
|
33
33
|
}
|
|
@@ -102,7 +102,7 @@
|
|
|
102
102
|
rdfs:label "ScholarX Research-Paper Ontology" ;
|
|
103
103
|
rdfs:comment """ScholarX research-paper model — papers and their preprint/journal
|
|
104
104
|
source repositories, subject categories, authors (shared :Person), abstracts and
|
|
105
|
-
full-text PDFs (shared :Document / :AssetOccurrence) — federated into the
|
|
105
|
+
full-text PDFs (shared :Document / :AssetOccurrence) — federated into the scion-sdk
|
|
106
106
|
knowledge-graph hub across arXiv, PMC, bioRxiv, medRxiv, PsyArXiv, OSF and
|
|
107
107
|
Semantic Scholar.""" .
|
|
108
108
|
|
|
@@ -21,12 +21,12 @@ from pathlib import Path
|
|
|
21
21
|
from urllib.parse import urljoin, urlsplit
|
|
22
22
|
|
|
23
23
|
import httpx
|
|
24
|
-
from
|
|
25
|
-
from
|
|
24
|
+
from scion_sdk.http.client import create_async_http_client
|
|
25
|
+
from scion_sdk.http.options import HttpClientOptions
|
|
26
26
|
|
|
27
27
|
logger = logging.getLogger(__name__)
|
|
28
28
|
|
|
29
|
-
from
|
|
29
|
+
from scion_sdk import paths
|
|
30
30
|
|
|
31
31
|
from .models import Paper
|
|
32
32
|
|
|
@@ -10,7 +10,7 @@ license: MIT
|
|
|
10
10
|
tags: [scholarx, 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 ScholarX paper-provider clients, deduplication and
|
|
20
20
|
storage behavior, MCP tools, packaged connector content, and agent entry
|
|
21
21
|
points. Shared connector contracts and transports belong to
|
|
22
|
-
`
|
|
22
|
+
`scion-sdk`; admission, serving, and durable graph state belong to
|
|
23
23
|
their owning repositories. Read `AGENTS.md` before changing code and keep
|
|
24
24
|
provider credentials, paper paths, and endpoints out of source, logs, and
|
|
25
25
|
skill content.
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: scholarx
|
|
3
|
-
Version: 2.3.
|
|
3
|
+
Version: 2.3.7
|
|
4
4
|
Summary: Universal Research Paper API — single entry point for arXiv, PMC, bioRxiv, medRxiv, PsyArXiv, OSF, and Semantic Scholar
|
|
5
5
|
Author-email: Repository Maintainers <maintainers@knuckles.team>
|
|
6
6
|
License: MIT
|
|
7
7
|
Requires-Python: <3.15,>=3.12
|
|
8
8
|
Description-Content-Type: text/markdown
|
|
9
9
|
License-File: LICENSE
|
|
10
|
-
Requires-Dist:
|
|
10
|
+
Requires-Dist: scion-sdk[mcp]<0.7.0,>=0.6.3
|
|
11
11
|
Requires-Dist: httpx>=0.28.1
|
|
12
12
|
Requires-Dist: python-dotenv>=1.2.4
|
|
13
13
|
Requires-Dist: Levenshtein>=0.27.5
|
|
@@ -15,7 +15,7 @@ Requires-Dist: pypdf>=6.21.0
|
|
|
15
15
|
Requires-Dist: rich>=15.0.0
|
|
16
16
|
Requires-Dist: defusedxml>=0.7.1
|
|
17
17
|
Provides-Extra: mcp
|
|
18
|
-
Requires-Dist:
|
|
18
|
+
Requires-Dist: scion-sdk[mcp]<0.7.0,>=0.6.3; extra == "mcp"
|
|
19
19
|
Provides-Extra: all
|
|
20
20
|
Requires-Dist: scholarx[mcp]; extra == "all"
|
|
21
21
|
Provides-Extra: test
|
|
@@ -151,7 +151,7 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
|
|
|
151
151
|
<!-- MCP-CONFIG-EXAMPLES:START -->
|
|
152
152
|
|
|
153
153
|
> **Install the connector-focused `[mcp]` extra.** Examples use `scholarx[mcp]` to add
|
|
154
|
-
> FastMCP / FastAPI through `
|
|
154
|
+
> FastMCP / FastAPI through `scion-sdk`; the required Scion SDK core
|
|
155
155
|
> still carries `epistemic-graph[full]`. The `[agent-runtime]` extra additionally
|
|
156
156
|
> enables model orchestration.
|
|
157
157
|
|
|
@@ -369,7 +369,7 @@ Detailed graph node architecture explanations, custom skill configurations, and
|
|
|
369
369
|
|
|
370
370
|
## Security & Governance
|
|
371
371
|
|
|
372
|
-
Built directly upon the enterprise-ready [`
|
|
372
|
+
Built directly upon the enterprise-ready [`scion-sdk`](https://github.com/Knuckles-Team/scion-sdk) core, standard security parameters are fully supported:
|
|
373
373
|
|
|
374
374
|
### Access Control & Policy Enforcement
|
|
375
375
|
- **Eunomia Policies:** Fine-grained, policy-driven tool authorization. Supports `none`, local `embedded` (`mcp_policies.json`), or centralized `remote` modes.
|
|
@@ -415,7 +415,7 @@ Built directly upon the enterprise-ready [`agent-connector-sdk`](https://github.
|
|
|
415
415
|
| `DISCOVERYTOOL` | `True` | |
|
|
416
416
|
| `STORAGETOOL` | `True` | |
|
|
417
417
|
|
|
418
|
-
#### Inherited
|
|
418
|
+
#### Inherited scion-sdk variables (apply to every connector)
|
|
419
419
|
|
|
420
420
|
| Variable | Example | Description |
|
|
421
421
|
|----------|---------|-------------|
|
|
@@ -434,7 +434,7 @@ Built directly upon the enterprise-ready [`agent-connector-sdk`](https://github.
|
|
|
434
434
|
| `MODEL_ID` | `gpt-4o` | Model id for the agent |
|
|
435
435
|
| `ENABLE_WEB_UI` | `True` | Serve the AG-UI web interface |
|
|
436
436
|
|
|
437
|
-
_21 package + 14 inherited variable(s). Auto-generated from `.env.example` + the shared
|
|
437
|
+
_21 package + 14 inherited variable(s). Auto-generated from `.env.example` + the shared scion-sdk set — do not edit._
|
|
438
438
|
<!-- ENV-VARS-TABLE:END -->
|
|
439
439
|
|
|
440
440
|
|
|
@@ -472,7 +472,7 @@ Pick the extra that matches what the operator want to run:
|
|
|
472
472
|
|
|
473
473
|
| Extra | Installs | Use when |
|
|
474
474
|
|-------|----------|----------|
|
|
475
|
-
| `scholarx[mcp]` | Connector-focused MCP server (`
|
|
475
|
+
| `scholarx[mcp]` | Connector-focused MCP server (`scion-sdk` — FastMCP/FastAPI + `epistemic-graph[full]`) | The operator only run the **MCP server** (smallest install / image) |
|
|
476
476
|
| `scholarx[all]` | Everything (`mcp` + `agent`) | Development / both surfaces |
|
|
477
477
|
|
|
478
478
|
```bash
|
|
@@ -501,7 +501,7 @@ agent (`immutable agent digest`) with a co-located `:mcp` sidecar.
|
|
|
501
501
|
|
|
502
502
|
### Knowledge-graph database (`epistemic-graph`)
|
|
503
503
|
|
|
504
|
-
|
|
504
|
+
Scion SDK core dependency (`epistemic-graph[full]`). The `[mcp]` extra keeps
|
|
505
505
|
deployments can use the bundled engine. For production or shared state, run
|
|
506
506
|
**epistemic-graph as a dedicated database service** and configure the runtime to use it.
|
|
507
507
|
Deployment recipes (single-node + Raft HA), connection configuration, and architecture
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
scion-sdk[mcp]<0.7.0,>=0.6.3
|
|
2
2
|
httpx>=0.28.1
|
|
3
3
|
python-dotenv>=1.2.4
|
|
4
4
|
Levenshtein>=0.27.5
|
|
@@ -10,7 +10,7 @@ defusedxml>=0.7.1
|
|
|
10
10
|
scholarx[mcp]
|
|
11
11
|
|
|
12
12
|
[mcp]
|
|
13
|
-
|
|
13
|
+
scion-sdk[mcp]<0.7.0,>=0.6.3
|
|
14
14
|
|
|
15
15
|
[test]
|
|
16
16
|
pytest-xdist>=3.8.0
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"""Action-discovery contract for the action-routed ScholarX MCP tools.
|
|
2
2
|
|
|
3
|
-
Each action-routed tool standardizes on the shared
|
|
3
|
+
Each action-routed tool standardizes on the shared scion-sdk helper
|
|
4
4
|
(``resolve_action``), so it must:
|
|
5
5
|
* return a ``list_actions`` discovery payload listing the valid actions, and
|
|
6
6
|
* raise a rich ``ValueError`` mentioning ``list_actions`` on an unknown action.
|
|
@@ -16,13 +16,9 @@ pytestmark = pytest.mark.spec("CONN-SCHOLARX-CONNECTOR-CONTENT-R001")
|
|
|
16
16
|
|
|
17
17
|
|
|
18
18
|
def _server():
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
"result = create_mcp_server('scholarx-mcp', version='0', command_args=[])",
|
|
23
|
-
namespace,
|
|
24
|
-
)
|
|
25
|
-
return namespace["result"][1]
|
|
19
|
+
from scion_sdk.connector import build_server
|
|
20
|
+
|
|
21
|
+
return build_server(PACKAGE, command_args=[])[1]
|
|
26
22
|
|
|
27
23
|
|
|
28
24
|
async def _listings():
|
|
@@ -12,7 +12,7 @@ from __future__ import annotations
|
|
|
12
12
|
from types import SimpleNamespace
|
|
13
13
|
|
|
14
14
|
import pytest
|
|
15
|
-
from
|
|
15
|
+
from scion_sdk.ingest import IngestError, KnowledgeIngest
|
|
16
16
|
|
|
17
17
|
from scholarx.kg_ingest import ingest_documents, ingest_entities, ingest_papers, paper_entities
|
|
18
18
|
from scholarx.models import Paper, PaperSource
|
|
@@ -23,7 +23,7 @@ class _FakeTransport:
|
|
|
23
23
|
self.requests: list[object] = []
|
|
24
24
|
|
|
25
25
|
async def source_status(self, connector, stream): # noqa: V107
|
|
26
|
-
return SimpleNamespace(accepted_checkpoint=None)
|
|
26
|
+
return SimpleNamespace(connector=connector, stream=stream, accepted_checkpoint=None)
|
|
27
27
|
|
|
28
28
|
async def submit(self, request):
|
|
29
29
|
self.requests.append(request)
|
|
@@ -10,7 +10,7 @@ from __future__ import annotations
|
|
|
10
10
|
from types import SimpleNamespace
|
|
11
11
|
|
|
12
12
|
import pytest
|
|
13
|
-
from
|
|
13
|
+
from scion_sdk.ingest import KnowledgeIngest
|
|
14
14
|
|
|
15
15
|
from scholarx.kg_media import ingest_pdf
|
|
16
16
|
from scholarx.models import Paper, PaperSource
|
|
@@ -21,7 +21,7 @@ class _FakeTransport:
|
|
|
21
21
|
self.requests: list[object] = []
|
|
22
22
|
|
|
23
23
|
async def source_status(self, connector, stream): # noqa: V107
|
|
24
|
-
return SimpleNamespace(accepted_checkpoint=None)
|
|
24
|
+
return SimpleNamespace(connector=connector, stream=stream, accepted_checkpoint=None)
|
|
25
25
|
|
|
26
26
|
async def submit(self, request):
|
|
27
27
|
self.requests.append(request)
|
|
@@ -3,11 +3,7 @@ from unittest.mock import AsyncMock, MagicMock, patch
|
|
|
3
3
|
import pytest
|
|
4
4
|
from fastmcp import Context
|
|
5
5
|
|
|
6
|
-
from scholarx.mcp_server import
|
|
7
|
-
get_mcp_instance,
|
|
8
|
-
mcp_server,
|
|
9
|
-
register_prompts,
|
|
10
|
-
)
|
|
6
|
+
from scholarx.mcp_server import register_prompts
|
|
11
7
|
from scholarx.models import Paper, PaperSource, SearchResult, SourceStatus
|
|
12
8
|
|
|
13
9
|
# ── Mock MCP Helper ─────────────────────────────────────────────────────────
|
|
@@ -277,7 +273,7 @@ async def test_sx_storage_basic_actions(mock_client):
|
|
|
277
273
|
assert res == {"downloads": {"job-123": {"status": "running"}}}
|
|
278
274
|
|
|
279
275
|
# Unknown action now raises a rich did-you-mean error pointing at list_actions
|
|
280
|
-
# (standardized via the shared
|
|
276
|
+
# (standardized via the shared scion-sdk action-discovery helper).
|
|
281
277
|
with pytest.raises(ValueError, match="list_actions"):
|
|
282
278
|
await call_sx_storage(action="nonsense")
|
|
283
279
|
|
|
@@ -608,48 +604,31 @@ def test_prompts():
|
|
|
608
604
|
mcp = MockMCP()
|
|
609
605
|
register_prompts(mcp)
|
|
610
606
|
|
|
611
|
-
assert "
|
|
607
|
+
assert "scion_sdk_enhancement_scan" in mcp.prompts
|
|
612
608
|
assert "biomimicry_innovation_scan" in mcp.prompts
|
|
613
609
|
|
|
614
|
-
prompt1 = mcp.prompts["
|
|
610
|
+
prompt1 = mcp.prompts["scion_sdk_enhancement_scan"]()
|
|
615
611
|
assert "Search for recent papers" in prompt1
|
|
616
612
|
|
|
617
613
|
prompt2 = mcp.prompts["biomimicry_innovation_scan"]()
|
|
618
614
|
assert "Search bioRxiv, PMC for" in prompt2
|
|
619
615
|
|
|
620
616
|
|
|
621
|
-
# ──
|
|
617
|
+
# ── Declared connector ──────────────────────────────────────────────────────
|
|
622
618
|
|
|
623
619
|
|
|
624
620
|
@pytest.mark.concept("SX-1.0")
|
|
625
|
-
def
|
|
626
|
-
|
|
627
|
-
args, mcp = get_mcp_instance()
|
|
628
|
-
assert args is not None
|
|
629
|
-
assert mcp is not None
|
|
621
|
+
def test_declared_connector_builds_server():
|
|
622
|
+
import asyncio
|
|
630
623
|
|
|
624
|
+
from fastmcp import Client
|
|
625
|
+
from scion_sdk.connector import build_server
|
|
631
626
|
|
|
632
|
-
|
|
633
|
-
def test_mcp_server_run_stdio():
|
|
634
|
-
mock_args = MagicMock()
|
|
635
|
-
mock_args.transport = "stdio"
|
|
636
|
-
|
|
637
|
-
mock_mcp = MagicMock()
|
|
638
|
-
|
|
639
|
-
with patch("scholarx.mcp_server.get_mcp_instance", return_value=(mock_args, mock_mcp)):
|
|
640
|
-
mcp_server()
|
|
641
|
-
mock_mcp.run.assert_called_once_with(transport="stdio")
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
@pytest.mark.concept("SX-1.0")
|
|
645
|
-
def test_mcp_server_run_http():
|
|
646
|
-
mock_args = MagicMock()
|
|
647
|
-
mock_args.transport = "http"
|
|
648
|
-
mock_args.host = "1.2.3.4"
|
|
649
|
-
mock_args.port = "8888"
|
|
627
|
+
_, mcp = build_server("scholarx", command_args=[])
|
|
650
628
|
|
|
651
|
-
|
|
629
|
+
async def _names():
|
|
630
|
+
async with Client(mcp) as client:
|
|
631
|
+
return {t.name for t in await client.list_tools()}
|
|
652
632
|
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
mock_mcp.run.assert_called_once_with(transport="streamable-http", host="1.2.3.4", port=8888)
|
|
633
|
+
names = asyncio.run(_names())
|
|
634
|
+
assert {"scholarx_search", "sx_search_get", "sx_storage_stored", "sx_info_sources"} <= names
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
[agent_connector_sdk.connector]
|
|
2
|
-
scholarx-mcp = scholarx
|
|
3
|
-
|
|
4
|
-
[agent_connector_sdk.ontology_providers]
|
|
5
|
-
scholarx = scholarx.ontology
|
|
6
|
-
|
|
7
|
-
[agent_connector_sdk.skill_providers]
|
|
8
|
-
scholarx = scholarx.skills
|
|
9
|
-
|
|
10
|
-
[console_scripts]
|
|
11
|
-
scholarx = scholarx.cli:cli
|
|
12
|
-
scholarx-mcp = scholarx.mcp_server:mcp_server
|
|
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
|
|
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
|
|
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
|