praisonai-mcp 0.0.2__tar.gz

praisonai_mcp-0.0.2/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: praisonai-mcp
+Version: 0.0.2
+Summary: MCP server hosting for PraisonAI — expose agents and tools to Cursor, Claude Desktop, and other MCP clients.
+Author: Mervin Praison
+License: MIT
+Project-URL: Homepage, https://docs.praison.ai
+Project-URL: Repository, https://github.com/mervinpraison/PraisonAI
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: praisonaiagents>=1.6.126
+Requires-Dist: mcp>=1.20.0
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12.0
+Requires-Dist: click>=8.4.2
+Provides-Extra: server
+Requires-Dist: starlette>=0.36.0; extra == "server"
+Requires-Dist: uvicorn>=0.27.0; extra == "server"
+Provides-Extra: auth
+Requires-Dist: httpx>=0.27.0; extra == "auth"
+Provides-Extra: all
+Requires-Dist: praisonai-mcp[auth,server]; extra == "all"
+
+# PraisonAI MCP
+
+Host PraisonAI agents and tools as an [MCP](https://modelcontextprotocol.io) server for Cursor, Claude Desktop, and other MCP clients.
+
+## Install
+
+```bash
+pip install "praisonai-mcp[all]"
+
+# Or via the umbrella product
+pip install "praisonai[mcp]"
+```
+
+## Quickstart
+
+```bash
+export OPENAI_API_KEY=sk-...
+# Standalone heavy host (full argparse options)
+praisonai-mcp serve --transport stdio
+praisonai-mcp list-tools
+praisonai-mcp doctor
+
+# Via umbrella CLI (same host commands on `praisonai mcp …`)
+praisonai mcp serve --transport stdio
+praisonai mcp list-tools
+```
+
+Config management (`list`, `add`, `sync`, `tools`, …) works on both `praisonai-mcp` and `praisonai mcp`.
+Full capability registry requires `praisonai` co-install (`_wrapper_bridge`).
+
+## Three MCP layers (do not conflate)
+
+| Layer | Package | Role |
+|-------|---------|------|
+| Client | `praisonaiagents[mcp]` | Connect agents to external MCP servers |
+| Light server | `praisonai-code` (`praisonai serve mcp`) | Basic `ToolsMCPServer` |
+| Heavy host | `praisonai-mcp` (this package) | Full capability/recipe MCP server |
+
+## Stack
+
+```
+praisonaiagents  (MCP client protocols)
+   └── praisonai-mcp  (this package)
+        └── praisonai  (wrapper shims: praisonai.mcp_server.*)
+```
+
+Boundary details: `src/praisonai/tests/PRAISONAI_MCP_MANIFEST.md`.

praisonai_mcp-0.0.2/README.md

@@ -0,0 +1,47 @@
+# PraisonAI MCP
+
+Host PraisonAI agents and tools as an [MCP](https://modelcontextprotocol.io) server for Cursor, Claude Desktop, and other MCP clients.
+
+## Install
+
+```bash
+pip install "praisonai-mcp[all]"
+
+# Or via the umbrella product
+pip install "praisonai[mcp]"
+```
+
+## Quickstart
+
+```bash
+export OPENAI_API_KEY=sk-...
+# Standalone heavy host (full argparse options)
+praisonai-mcp serve --transport stdio
+praisonai-mcp list-tools
+praisonai-mcp doctor
+
+# Via umbrella CLI (same host commands on `praisonai mcp …`)
+praisonai mcp serve --transport stdio
+praisonai mcp list-tools
+```
+
+Config management (`list`, `add`, `sync`, `tools`, …) works on both `praisonai-mcp` and `praisonai mcp`.
+Full capability registry requires `praisonai` co-install (`_wrapper_bridge`).
+
+## Three MCP layers (do not conflate)
+
+| Layer | Package | Role |
+|-------|---------|------|
+| Client | `praisonaiagents[mcp]` | Connect agents to external MCP servers |
+| Light server | `praisonai-code` (`praisonai serve mcp`) | Basic `ToolsMCPServer` |
+| Heavy host | `praisonai-mcp` (this package) | Full capability/recipe MCP server |
+
+## Stack
+
+```
+praisonaiagents  (MCP client protocols)
+   └── praisonai-mcp  (this package)
+        └── praisonai  (wrapper shims: praisonai.mcp_server.*)
+```
+
+Boundary details: `src/praisonai/tests/PRAISONAI_MCP_MANIFEST.md`.

praisonai_mcp-0.0.2/praisonai_mcp/__init__.py

@@ -0,0 +1,26 @@
+"""MCP server hosting for PraisonAI — expose agents and tools to MCP clients.
+
+Example:
+    praisonai-mcp serve --transport stdio
+
+    from praisonai_mcp.mcp_server import MCPServer
+    server = MCPServer()
+    server.run(transport="stdio")
+"""
+
+from __future__ import annotations
+
+from praisonai_mcp._version import __version__
+
+
+def __getattr__(name: str):
+    if name == "MCPServer":
+        from praisonai_mcp.mcp_server.server import MCPServer
+        return MCPServer
+    if name == "handle_mcp_command":
+        from praisonai_mcp.mcp_server.cli import handle_mcp_command
+        return handle_mcp_command
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = ["__version__", "MCPServer", "handle_mcp_command"]

praisonai_mcp-0.0.2/praisonai_mcp/__main__.py

@@ -0,0 +1,38 @@
+"""Console entry: ``praisonai-mcp``."""
+
+from __future__ import annotations
+
+import sys
+
+# Heavy MCP host commands (MCPServerCLI) — not Typer config subcommands.
+_HOST_COMMANDS = frozenset({
+    "serve",
+    "serve-recipe",
+    "list-tools",
+    "list-resources",
+    "list-prompts",
+    "list-recipes",
+    "validate-recipe",
+    "inspect-recipe",
+    "config-generate",
+    "config-generate-recipe",
+    "tasks",
+    "doctor",
+})
+
+
+def main(argv: list[str] | None = None) -> None:
+    args = argv if argv is not None else sys.argv[1:]
+    if not args:
+        args = ["--help"]
+    if args[0] in _HOST_COMMANDS:
+        from praisonai_mcp.mcp_server.cli import handle_mcp_command
+
+        raise SystemExit(handle_mcp_command(args))
+    from praisonai_mcp.cli.app import app
+
+    app(args=args, prog_name="praisonai-mcp")
+
+
+if __name__ == "__main__":
+    main()

praisonai_mcp-0.0.2/praisonai_mcp/_bootstrap.py

@@ -0,0 +1,35 @@
+"""Monorepo bootstrap for ``praisonai_mcp`` and optional ``praisonai_code``."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+
+def ensure_praisonai_mcp() -> None:
+    try:
+        import praisonai_mcp  # noqa: F401
+        return
+    except ImportError:
+        pass
+
+    here = Path(__file__).resolve().parents[1]
+    if (here / "praisonai_mcp").is_dir():
+        root = str(here)
+        if root not in sys.path:
+            sys.path.insert(0, root)
+
+
+def ensure_praisonai_code() -> None:
+    try:
+        import praisonai_code  # noqa: F401
+        return
+    except ImportError:
+        pass
+
+    mcp_src = Path(__file__).resolve().parents[1]
+    code_src = mcp_src.parent / "praisonai-code"
+    if (code_src / "praisonai_code").is_dir():
+        root = str(code_src)
+        if root not in sys.path:
+            sys.path.insert(0, root)

praisonai_mcp-0.0.2/praisonai_mcp/_code_bridge.py

@@ -0,0 +1,28 @@
+"""Lazy access from praisonai-mcp to optional praisonai-code modules."""
+
+from __future__ import annotations
+
+import importlib
+from typing import Any
+
+from praisonai_mcp._bootstrap import ensure_praisonai_code
+
+
+def code_available() -> bool:
+    ensure_praisonai_code()
+    try:
+        import praisonai_code  # noqa: F401
+        return True
+    except ImportError:
+        return False
+
+
+def import_code_module(name: str) -> Any:
+    ensure_praisonai_code()
+    try:
+        return importlib.import_module(name)
+    except ImportError as exc:
+        raise ImportError(
+            f"Optional code module {name!r} requires praisonai-code. "
+            "Install with: pip install praisonai-code"
+        ) from exc

praisonai_mcp-0.0.2/praisonai_mcp/_version.py

@@ -0,0 +1 @@
+__version__ = "0.0.2"

praisonai_mcp-0.0.2/praisonai_mcp/_wrapper_bridge.py

@@ -0,0 +1,36 @@
+"""Lazy access from praisonai-mcp to optional praisonai wrapper modules."""
+
+from __future__ import annotations
+
+import importlib
+from typing import Any, Callable
+
+
+def wrapper_available() -> bool:
+    try:
+        import praisonai  # noqa: F401
+        return True
+    except ImportError:
+        return False
+
+
+def import_wrapper_module(name: str) -> Any:
+    if not wrapper_available():
+        raise ImportError(
+            f"Optional wrapper module {name!r} requires the praisonai package. "
+            "Install with: pip install praisonai"
+        )
+    return importlib.import_module(name)
+
+
+def wrapper_callable(module: str, attr: str) -> Callable[..., Any]:
+    return getattr(import_wrapper_module(module), attr)
+
+
+def optional_wrapper_callable(
+    module: str, attr: str, default: Callable[..., Any] | None = None
+) -> Callable[..., Any] | None:
+    try:
+        return wrapper_callable(module, attr)
+    except ImportError:
+        return default

praisonai_mcp-0.0.2/praisonai_mcp/cli/_configuration.py

@@ -0,0 +1,27 @@
+"""Lazy config helpers from praisonai-code (optional co-install)."""
+
+from __future__ import annotations
+
+from praisonai_mcp._code_bridge import import_code_module
+
+
+def get_config_loader():
+    fn = import_code_module("praisonai_code.cli.configuration.loader").get_config_loader
+    return fn()
+
+
+def configuration_schema():
+    return import_code_module("praisonai_code.cli.configuration.schema")
+
+
+def configuration_paths():
+    return import_code_module("praisonai_code.cli.configuration.paths")
+
+
+def configuration_loader_helpers():
+    return import_code_module("praisonai_code.cli.configuration.loader")
+
+
+def get_output_controller():
+    fn = import_code_module("praisonai_code.cli.output.console").get_output_controller
+    return fn()

praisonai_mcp-0.0.2/praisonai_mcp/cli/app.py

@@ -0,0 +1,7 @@
+"""Typer CLI for standalone ``praisonai-mcp``."""
+
+from __future__ import annotations
+
+from praisonai_mcp.cli.commands.mcp import app
+
+__all__ = ["app"]