Toreleon cli (#22)

* Add CI/CD workflows for testing, version bumping, and PyPI publishing; enhance README with development and CI/CD details; implement comprehensive tests for MCPHub and MCPServers functionality.

* Enhance CI workflow by installing all extras with Poetry

* Refactor CI workflow to include version bumping and streamline package publishing using Poetry

* Update README to clarify MCPHub installation options with framework-specific dependencies

* Restrict pull request triggers to the release branch only

* Update CI workflow to enable fail-fast strategy and restrict Python versions to 3.12 only

* Refactor CI workflows to remove version bumping from CI and add tagging functionality; update README for clarity on automatic versioning and tagging process.

* Refactor CI workflows to integrate version bumping and ensure proper versioning before publishing; update version-bump workflow to set outputs for new version.

* Bump version to 0.1.6 in pyproject.toml

* Refactor CI workflows: remove version-bump workflow and integrate version extraction and tagging directly in the publish job; update package version to 0.1.7 in pyproject.toml

* Fix test data structure in TestMCPServersParams to match expected format

Updated the mock data in the test for _load_predefined_servers_params to reflect the correct structure, ensuring that the "mcpServers" key wraps the predefined server details. This change enhances the accuracy of the test and aligns it with the actual implementation.

* Add CLI commands and utilities for MCPHub configuration management

- Implemented CLI commands for initializing, adding, removing, and listing MCP servers.
- Created utility functions for loading and saving configuration files.
- Added tests for CLI commands to ensure proper functionality and error handling.

Author: toreleon

src/mcphub/test.py renamed to examples/with_config/test.py

@@ -1,26 +1,34 @@
 from mcphub import MCPHub
-import json
 
-async def main():
+server_name = "Gloomysunday28/mcp-server"
 
+async def framework_examples():
     hub = MCPHub()
 
+    # 1. OpenAI Agents Integration
     async with hub.fetch_openai_mcp_server(
-        mcp_name="MCP-Mirror/Automata-Labs-team_MCP-Server-Playwright",
+        mcp_name=server_name,
         cache_tools_list=True
     ) as server:
-        # Step 3: List available tools from the MCP server
-        # This shows what capabilities are available to your agent
         tools = await server.list_tools()
-        
-        # Pretty print the tools for better readability
-        tools_dict = [
-            dict(tool) if hasattr(tool, "__dict__") else tool for tool in tools
-        ]
-        print("Available MCP Tools:")
-        print(json.dumps(tools_dict, indent=2))
+        print(f"Tools from MCP server: {tools}")
+    # 2. LangChain Tools Integration
+    langchain_tools = await hub.fetch_langchain_mcp_tools(
+        mcp_name=server_name,
+        cache_tools_list=True
+    )
+    
+    print(f"LangChain tools from MCP server: {langchain_tools}")
+    
+    # 3. Autogen Adapters Integration
+    autogen_adapters = await hub.fetch_autogen_mcp_adapters(
+        mcp_name=server_name
+    )
+    # Use adapters with Autogen
+
+    print(f"Autogen adapters from MCP server: {autogen_adapters}")
 
 
 if __name__ == "__main__":
     import asyncio
-    asyncio.run(main())
+    asyncio.run(framework_examples())

examples/without_config/test.py

@@ -0,0 +1 @@
+# CLI package for MCPHub

src/mcphub/cli/__init__.py

@@ -0,0 +1,162 @@
+"""CLI commands for mcphub."""
+import argparse
+import json
+import sys
+from pathlib import Path
+from typing import Dict, Any, List, Optional
+
+from .utils import (
+    load_config,
+    save_config,
+    DEFAULT_CONFIG,
+    get_config_path,
+    add_server_config,
+    remove_server_config,
+    list_available_servers,
+    list_configured_servers
+)
+
+def init_command(args):
+    """Initialize a new .mcphub.json configuration file in the current directory."""
+    config_path = get_config_path()
+    if config_path.exists():
+        print(f"Configuration file already exists at: {config_path}")
+        return
+
+    save_config(DEFAULT_CONFIG)
+    print(f"Created new configuration file at: {config_path}")
+
+def add_command(args):
+    """Add a preconfigured MCP server to the local config."""
+    server_name = args.mcp_name
+    non_interactive = args.non_interactive if hasattr(args, 'non_interactive') else False
+    
+    success, missing_env_vars = add_server_config(server_name, interactive=not non_interactive)
+    
+    if not success:
+        print(f"Error: MCP server '{server_name}' not found in preconfigured servers")
+        # Show available options
+        print("\nAvailable preconfigured servers:")
+        available_servers = list_available_servers()
+        for name in available_servers:
+            print(f"- {name}")
+        sys.exit(1)
+    
+    print(f"Added configuration for '{server_name}' to .mcphub.json")
+    
+    # Notify about missing environment variables
+    if missing_env_vars:
+        print("\nWarning: The following environment variables are required but not set:")
+        for var in missing_env_vars:
+            print(f"- {var}")
+        print("\nYou can either:")
+        print("1. Set them in your environment before using this server")
+        print("2. Run 'mcphub add-env' to add them to your configuration")
+        print("3. Edit .mcphub.json manually to set the values")
+
+def remove_command(args):
+    """Remove an MCP server configuration from the local config."""
+    server_name = args.mcp_name
+    if remove_server_config(server_name):
+        print(f"Removed configuration for '{server_name}' from .mcphub.json")
+    else:
+        print(f"Error: MCP server '{server_name}' not found in current configuration")
+        # Show what's currently configured
+        configured = list_configured_servers()
+        if configured:
+            print("\nCurrently configured servers:")
+            for name in configured:
+                print(f"- {name}")
+        sys.exit(1)
+
+def list_command(args):
+    """List all configured and available MCP servers."""
+    show_all = args.all if hasattr(args, 'all') else False
+    
+    configured = list_configured_servers()
+    print("Configured MCP servers:")
+    if configured:
+        for name in configured:
+            print(f"- {name}")
+    else:
+        print("  No servers configured in local .mcphub.json")
+    
+    if show_all:
+        available = list_available_servers()
+        print("\nAvailable preconfigured MCP servers:")
+        if available:
+            for name in available:
+                print(f"- {name}")
+        else:
+            print("  No preconfigured servers available")
+
+def parse_args(args=None):
+    """Parse command line arguments."""
+    parser = argparse.ArgumentParser(
+        description="MCPHub CLI tool for managing MCP server configurations"
+    )
+    
+    subparsers = parser.add_subparsers(dest="command", help="Commands")
+    
+    # Init command
+    init_parser = subparsers.add_parser(
+        "init", 
+        help="Create a new .mcphub.json file in the current directory"
+    )
+    
+    # Add command
+    add_parser = subparsers.add_parser(
+        "add", 
+        help="Add a preconfigured MCP server to your local config"
+    )
+    add_parser.add_argument(
+        "mcp_name", 
+        help="Name of the preconfigured MCP server to add"
+    )
+    add_parser.add_argument(
+        "-n", "--non-interactive",
+        action="store_true",
+        help="Don't prompt for environment variables"
+    )
+    
+    # Remove command
+    remove_parser = subparsers.add_parser(
+        "remove", 
+        help="Remove an MCP server from your local config"
+    )
+    remove_parser.add_argument(
+        "mcp_name", 
+        help="Name of the MCP server to remove"
+    )
+    
+    # List command
+    list_parser = subparsers.add_parser(
+        "list", 
+        help="List configured MCP servers"
+    )
+    list_parser.add_argument(
+        "-a", "--all", 
+        action="store_true", 
+        help="Show all available preconfigured servers"
+    )
+    
+    return parser.parse_args(args)
+
+def main():
+    """Main entry point for the CLI."""
+    args = parse_args()
+    
+    if args.command == "init":
+        init_command(args)
+    elif args.command == "add":
+        add_command(args)
+    elif args.command == "remove":
+        remove_command(args)
+    elif args.command == "list":
+        list_command(args)
+    else:
+        # Show help if no command is provided
+        parse_args(["-h"])
+
+if __name__ == "__main__":
+    main()