astp-docs-server 0.1.0__py3-none-any.whl

astp_docs_server/__init__.py

@@ -0,0 +1,12 @@
+"""Open documentation server for ASTP — MCP + web-chat heads over the open corpus.
+
+Two transports on one substrate: the FastMCP server (`mcp_server`) for adopters'
+coding agents, and the web-chat head (`web/`) for the docs site. Both consume the
+shared `astp_docs` core + `astp_docs.toolkit` and cite identical chunks. Serves
+ONLY the open protocol corpus.
+
+The package `__init__` stays import-light on purpose: it does NOT import the MCP
+transport, so the web head runs without the `mcp` dependency installed. Import the
+server explicitly where needed:  `from astp_docs_server.mcp_server import run`.
+"""
+__version__ = "0.1.0"

astp_docs_server/__main__.py

@@ -0,0 +1,8 @@
+"""Run the open MCP server:  python -m astp_docs_server
+
+(For the web-chat head instead:  python -m astp_docs_server.web)
+"""
+from .mcp_server import run
+
+if __name__ == "__main__":
+    run()

astp_docs_server/atlas_manifest.py

@@ -0,0 +1,108 @@
+"""Atlas service manifest for the ASTP Open Docs MCP Server.
+
+Registers the server's read-only capabilities with Atlas so agents can discover
+it. All tools are ``read`` (a docs server writes nothing). No API keys.
+
+    from astp_docs_server.atlas_manifest import get_astp_docs_open_manifest
+    await atlas.register_service(get_astp_docs_open_manifest())
+"""
+from __future__ import annotations
+
+from typing import Any
+
+
+def _read_cap(cap_id: str, tool_name: str, name: str, desc: str, schema: dict) -> dict:
+    return {
+        "id": cap_id,
+        "name": name,
+        "tool_name": tool_name,
+        "capability_type": "read",
+        "description": desc,
+        "schema": schema,
+        "required_permissions": ["astp.docs.read"],
+    }
+
+
+def get_astp_docs_open_manifest() -> dict[str, Any]:
+    return {
+        "service_id": "astp-docs-open",
+        "name": "ASTP Open Docs MCP Server",
+        "version": "0.1.0",
+        "description": (
+            "Serves the OPEN ASTP protocol corpus (SPEC, "
+            "IMPLEMENTATION/CONFORMANCE companions, GLOSSARY, CHANGELOG) with "
+            "exact lookup of governance rules, conformance vectors, and sections "
+            "plus lexical search. Read-only; no proprietary content."
+        ),
+        "mcp_endpoint": "stdio://astp-docs-open",
+        "health_endpoint": None,
+        "docs_url": "https://github.com/scorched-earth-labs/astp-docs",
+        "contact": {"team": "ASTP Protocol", "email": "protocol@scorchedearthlabs.com"},
+        "metadata": {
+            "category": "documentation",
+            "corpus_visibility": "open",
+            "requires_api_keys": [],
+            "cost_model": "free",
+        },
+        "capabilities": [
+            _read_cap(
+                "astp.docs.search_spec", "search_spec", "Search Spec",
+                "Search the protocol corpus for relevant passages (lexical; semantic in a later release).",
+                {
+                    "type": "object",
+                    "properties": {
+                        "query": {"type": "string", "description": "What to find"},
+                        "k": {"type": "integer", "default": 5, "minimum": 1, "maximum": 20},
+                    },
+                    "required": ["query"],
+                },
+            ),
+            _read_cap(
+                "astp.docs.get_governance_rule", "get_governance_rule", "Get Governance Rule",
+                "Fetch a governance rule G-1..G-43 verbatim with citation.",
+                {
+                    "type": "object",
+                    "properties": {"rule_id": {"type": "string", "description": "e.g. G-2"}},
+                    "required": ["rule_id"],
+                },
+            ),
+            _read_cap(
+                "astp.docs.get_conformance_vectors", "get_conformance_vectors", "Get Conformance Vectors",
+                "Fetch a conformance vector by id (WF-004) or a family by prefix (WF).",
+                {
+                    "type": "object",
+                    "properties": {"id_or_family": {"type": "string", "description": "e.g. WF-004 or WF"}},
+                    "required": ["id_or_family"],
+                },
+            ),
+            _read_cap(
+                "astp.docs.get_section", "get_section", "Get Section",
+                "Fetch a numbered spec section verbatim.",
+                {
+                    "type": "object",
+                    "properties": {
+                        "section_id": {"type": "string", "description": "e.g. 5.2"},
+                        "doc": {"type": "string", "description": "Optional doc id, e.g. SPEC"},
+                    },
+                    "required": ["section_id"],
+                },
+            ),
+            _read_cap(
+                "astp.docs.get_hash_preimage", "get_hash_preimage", "Get Hash Preimage",
+                "Find how a type's content hash is built (fields + order).",
+                {
+                    "type": "object",
+                    "properties": {
+                        "type_name": {"type": "string", "description": "e.g. WorkflowDeclaration"},
+                        "k": {"type": "integer", "default": 5, "minimum": 1, "maximum": 20},
+                    },
+                    "required": ["type_name"],
+                },
+            ),
+            _read_cap(
+                "astp.docs.corpus_info", "corpus_info", "Corpus Info",
+                "Report served doc count, governance rules, and conformance families.",
+                {"type": "object", "properties": {}},
+            ),
+        ],
+    }