web-algebra mcp runs the MCP server; 2.0.1 for the MCP Registry

CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to Web Algebra are recorded here. The format follows
 [Semantic Versioning](https://semver.org/). The normative definition of every
 operation is [formal-semantics.md](formal-semantics.md).
 
+## [2.0.1] - 2026-10-21
+
+### Added
+
+- **`web-algebra mcp`** runs the MCP server on stdio, as `web-algebra-mcp`
+  does. The MCP Registry entry (`server.json`) runs it: a registry client
+  starts a PyPI package as `uvx web-algebra`, which on its own starts the
+  planner.
+
 ## [2.0.0] - 2026-10-21
 
 Web Algebra now has a formal semantics, and the Python implementation conforms

README.md

@@ -169,6 +169,8 @@ or with Claude Code:
 claude mcp add web-algebra -e CERT_PEM_PATH=/path/to/LinkedDataHub/ssl/owner/cert.pem -e CERT_PASSWORD=******** -- uvx --from web-algebra web-algebra-mcp
 ```
 
+`uvx web-algebra mcp` runs the same server.
+
 Environment variables:
 
 | Name | Required | Description |

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "web-algebra"
-version = "2.0.0"
+version = "2.0.1"
 description = "Composable RDF operations in JSON"
 readme = "README.md"
 license = "Apache-2.0"

server.json

@@ -7,13 +7,19 @@
     "url": "https://github.com/AtomGraph/Web-Algebra",
     "source": "github"
   },
-  "version": "2.0.0",
+  "version": "2.0.1",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "web-algebra",
-      "version": "2.0.0",
+      "version": "2.0.1",
       "runtimeHint": "uvx",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ],
       "transport": {
         "type": "stdio"
       },

src/web_algebra/main.py

@@ -135,6 +135,12 @@ def main(settings: BaseSettings, json_data: Optional[str]):
 
 def cli() -> None:
     parser = argparse.ArgumentParser(description="Run the AI-powered DSL interpreter.")
+    parser.add_argument(
+        "command",
+        nargs="?",
+        choices=["mcp"],
+        help="mcp: run the MCP server on stdio, as web-algebra-mcp does",
+    )
     parser.add_argument(
         "--from-json",
         type=str,
@@ -152,6 +158,12 @@ def cli() -> None:
     )
     args = parser.parse_args()
 
+    if args.command == "mcp":
+        from web_algebra.__main__ import main as serve
+
+        serve()
+        return
+
     # the flags override CERT_PEM_PATH / CERT_PASSWORD, which the settings
     # read from the environment, as the MCP server and the tests do
     overrides = {

tests/test_mcp_server.py

@@ -48,9 +48,9 @@ def mcp_tools():
 
 
 class Stdio:
-    def __init__(self):
+    def __init__(self, command=("-m", "web_algebra")):
         self.proc = subprocess.Popen(
-            [sys.executable, "-m", "web_algebra"],
+            [sys.executable, *command],
             stdin=subprocess.PIPE,
             stdout=subprocess.PIPE,
             stderr=subprocess.DEVNULL,
@@ -106,6 +106,16 @@ def test_initialize_names_the_server_and_its_version(stdio):
     assert info["version"] == version("web-algebra")
 
 
+def test_the_cli_mcp_command_is_the_stdio_server():
+    # `web-algebra mcp` is what an MCP Registry client runs (server.json)
+    server = Stdio(("-m", "web_algebra.main", "mcp"))
+    try:
+        answer = server.request("initialize", INITIALIZE, timeout=60)
+    finally:
+        server.close()
+    assert answer["result"]["serverInfo"]["name"] == "web-algebra"
+
+
 def test_initialize_offers_tools(stdio):
     assert "tools" in stdio.initialized["result"]["capabilities"]
 

tests/test_packaging.py

@@ -39,6 +39,11 @@ def test_server_json_names_the_pypi_package():
     assert [p["identifier"] for p in SERVER["packages"] if p["registryType"] == "pypi"] == ["web-algebra"]
 
 
+def test_server_json_runs_the_mcp_command():
+    # `uvx web-algebra` alone would start the planner, not the server
+    assert [p.get("packageArguments") for p in SERVER["packages"]] == [[{"type": "positional", "value": "mcp"}]]
+
+
 def test_readme_carries_the_server_name():
     assert f"mcp-name: {SERVER['name']} " in (ROOT / "README.md").read_text().replace("-->", " -->")