nextmv 1.1.2.dev0__tar.gz → 1.1.3.dev1__tar.gz

{nextmv-1.1.2.dev0 → nextmv-1.1.3.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextmv
-Version: 1.1.2.dev0
+Version: 1.1.3.dev1
 Summary: The all-purpose Python SDK for Nextmv
 Project-URL: Homepage, https://www.nextmv.io
 Project-URL: Documentation, https://nextmv-py.docs.nextmv.io/en/latest/nextmv/
@@ -226,6 +226,12 @@ Requires-Dist: pyyaml>=6.0.1
 Requires-Dist: requests>=2.31.0
 Requires-Dist: typer>=0.20.1
 Requires-Dist: urllib3>=2.1.0
+Provides-Extra: all
+Requires-Dist: folium>=0.20.0; extra == 'all'
+Requires-Dist: mcp[cli]>=1.0; extra == 'all'
+Requires-Dist: plotly>=6.0.1; extra == 'all'
+Provides-Extra: mcp
+Requires-Dist: mcp[cli]>=1.0; extra == 'mcp'
 Provides-Extra: notebook
 Requires-Dist: mlflow>=3.9.0; extra == 'notebook'
 Description-Content-Type: text/markdown

nextmv-1.1.3.dev1/nextmv/__about__.py

@@ -0,0 +1 @@
+__version__ = "v1.1.3.dev1"

{nextmv-1.1.2.dev0 → nextmv-1.1.3.dev1}/nextmv/cli/main.py

@@ -26,6 +26,7 @@ from nextmv.cli.configuration import app as configuration_app
 from nextmv.cli.configuration.config import CONFIG_DIR, GO_CLI_PATH, load_config
 from nextmv.cli.confirm import get_confirmation
 from nextmv.cli.local import app as local_app
+from nextmv.cli.mcp import app as mcp_app
 from nextmv.cli.message import error, info, success, warning
 from nextmv.cli.version import app as version_app
 from nextmv.cli.version import version_callback
@@ -50,6 +51,7 @@ app.add_typer(cloud_app, name="cloud")
 app.add_typer(community_app, name="community")
 app.add_typer(configuration_app, name="configuration")
 app.add_typer(local_app, name="local")
+app.add_typer(mcp_app, name="mcp")
 app.add_typer(version_app)
 
 
@@ -76,7 +78,7 @@ def callback(
         return
 
     # Skip checks for certain commands.
-    ignored_commands = {"configuration", "version"}
+    ignored_commands = {"configuration", "mcp", "version"}
     if ctx.invoked_subcommand in ignored_commands:
         return
 

nextmv-1.1.3.dev1/nextmv/cli/mcp/__init__.py

@@ -0,0 +1,26 @@
+"""MCP (Model Context Protocol) server for the Nextmv CLI."""
+
+import typer
+
+from nextmv.cli.mcp.serve import app as serve_app
+
+# Set up subcommand application.
+app = typer.Typer()
+app.add_typer(serve_app)
+
+
+@app.callback()
+def callback() -> None:
+    """
+    Model Context Protocol (MCP) server for LLM integrations.
+
+    Start an MCP server so that any MCP-compatible client (Claude Code,
+    Cursor, VS Code, etc.) can interact with Nextmv Cloud through natural
+    language.
+
+    [bold][underline]Quick start[/underline][/bold]
+
+    - Register with Claude Code.
+        $ [dim]claude mcp add nextmv -- nextmv mcp serve[/dim]
+    """
+    pass

nextmv-1.1.3.dev1/nextmv/cli/mcp/serve.py

@@ -0,0 +1,76 @@
+"""MCP server command for the Nextmv CLI."""
+
+from typing import Annotated
+
+import typer
+
+from nextmv.cli.message import error
+
+# Set up subcommand application.
+app = typer.Typer()
+
+
+@app.command()
+def serve(
+    port: Annotated[
+        int,
+        typer.Option(
+            "--port",
+            help="Port for the HTTP transport.",
+            metavar="PORT",
+        ),
+    ] = 8080,
+    transport: Annotated[
+        str,
+        typer.Option(
+            "--transport",
+            "-t",
+            help="Transport protocol. "
+            "Allowed values: [magenta]stdio[/magenta], [magenta]streamable-http[/magenta].",
+            metavar="TRANSPORT",
+        ),
+    ] = "stdio",
+) -> None:
+    """
+    Start the Nextmv MCP server.
+
+    The MCP server exposes Nextmv Cloud functionality as tools that any
+    MCP-compatible client can use. The default transport is
+    [magenta]stdio[/magenta], which is what Claude Code, Cursor, and most
+    local clients expect.
+
+    Requires the [magenta]mcp[/magenta] optional dependency. Install with:
+    [code]pip install 'nextmv[mcp]'[/code]
+
+    [bold][underline]Examples[/underline][/bold]
+
+    - Start the MCP server with stdio transport (default).
+        $ [dim]nextmv mcp serve[/dim]
+
+    - Start the MCP server with HTTP transport on port 9090.
+        $ [dim]nextmv mcp serve --transport streamable-http --port 9090[/dim]
+
+    - Register with Claude Code.
+        $ [dim]claude mcp add nextmv -- nextmv mcp serve[/dim]
+    """
+
+    try:
+        from nextmv.cli.mcp.server import create_server
+    except ImportError:
+        error(
+            "MCP support requires the [magenta]mcp[/magenta] package. "
+            "Install with: [code]pip install 'nextmv[mcp]'[/code]"
+        )
+        return  # unreachable, error() raises
+
+    server = create_server()
+
+    if transport == "stdio":
+        server.run(transport="stdio")
+    elif transport in ("http", "streamable-http"):
+        server.run(transport="streamable-http", port=port)
+    else:
+        error(
+            f"Unknown transport [magenta]{transport}[/magenta]. "
+            "Allowed values are: [magenta]stdio[/magenta], [magenta]streamable-http[/magenta]."
+        )