mcp.installers.safe_pattern_installer
=====================================

.. py:module:: mcp.installers.safe_pattern_installer

.. autoapi-nested-parse::

   Safe Pattern-Based MCP Server Installer.

   Version 1: Uses predefined patterns for safe, predictable installations.
   No code generation - only trusted, tested patterns.



Classes
-------

.. autoapisummary::

   mcp.installers.safe_pattern_installer.InstallationRequest
   mcp.installers.safe_pattern_installer.InstallationResult
   mcp.installers.safe_pattern_installer.SafePatternInstaller


Module Contents
---------------

.. py:class:: InstallationRequest(/, **data: Any)

   Bases: :py:obj:`pydantic.BaseModel`


   Request for MCP server installation.


   .. py:attribute:: custom_args
      :type:  list[str]
      :value: None



   .. py:attribute:: env_vars
      :type:  dict[str, str]
      :value: None



   .. py:attribute:: package_name
      :type:  str
      :value: None



   .. py:attribute:: pattern_type
      :type:  str
      :value: None



   .. py:attribute:: require_approval
      :type:  bool
      :value: None



   .. py:attribute:: server_name
      :type:  str
      :value: None



.. py:class:: InstallationResult(/, **data: Any)

   Bases: :py:obj:`pydantic.BaseModel`


   Result of installation attempt.


   .. py:attribute:: config_created
      :type:  bool
      :value: False



   .. py:attribute:: message
      :type:  str


   .. py:attribute:: process_id
      :type:  int | None
      :value: None



   .. py:attribute:: server_name
      :type:  str


   .. py:attribute:: success
      :type:  bool


   .. py:attribute:: tools_available
      :type:  list[str]
      :value: None



.. py:class:: SafePatternInstaller(config_manager: haive.mcp.installers.config_manager.MCPConfigManager | None = None)

   Safe MCP installer using only predefined patterns.


   .. py:method:: check_server_status(server_name: str) -> str

      Check if an MCP server is running.



   .. py:method:: cleanup() -> None

      Stop all running servers.



   .. py:method:: create_installation_tool(request: InstallationRequest) -> langchain_core.tools.StructuredTool

      Create a tool for installing a specific MCP server.



   .. py:method:: create_quick_install_tools() -> list[langchain_core.tools.StructuredTool]

      Create tools for common MCP server installations.



   .. py:method:: get_pattern_for_server(package_name: str, suggested_pattern: str) -> haive.mcp.installers.config_manager.MCPServerPattern | None

      Get the appropriate pattern for a server.



   .. py:method:: get_status_summary() -> dict[str, Any]

      Get summary of installer status.



   .. py:method:: start_server(server_name: str) -> InstallationResult
      :async:


      Start a configured MCP server.



   .. py:method:: validate_installation_request(request: InstallationRequest) -> tuple[bool, str]

      Validate that installation request is safe.



   .. py:attribute:: config_manager


   .. py:attribute:: request_counters
      :type:  dict[str, int]


   .. py:attribute:: running_servers
      :type:  dict[str, subprocess.Popen]