Add tests and core implementation for MCP server functionality

Introduces MCP server implementation with stdio transport and test suite for basic/advanced Click command functionality. Includes tool scanning, command invocation, and error handling tests.

Author: amazon-q-developer[bot]

click_mcp/scanner.py

@@ -41,7 +41,7 @@ def scan_click_command(command: click.Group, parent_path: str = "") -> List[type
         # Determine command path
         custom_name = metadata.get("name", name)
         # Ensure paths use underscore separator instead of dot
-        cmd_path = f"{parent_path}{custom_name}" if parent_path else custom_name
+        cmd_path = _sanitize_tool_name(f"{parent_path}{custom_name}" if parent_path else custom_name)
 
         if "commands" in cmd_info:
             # Handle subgroup

click_mcp/server.py

@@ -119,7 +119,9 @@ def _find_command(self, group: click.Group, path: List[str]) -> click.Command:
         if path[0] == group.name:
             return self._find_command(group, path[1:])
 
-        current, *remaining = path
+        # Convert underscore-separated path back to dot notation for lookups
+        current = path[0].replace('_', '.')
+        remaining = path[1:]
 
         # Try to find the command by name
         if current in group.commands:

tests/test_mcp_server.py

@@ -78,7 +78,7 @@ async def test_basic_server_tools(basic_mcp_session):
     # Find the users.list command
     users_list_tool = None
     for tool in tools:
-        if "users.list" in tool.name.lower():
+        if "users_list" in tool.name.lower():
             users_list_tool = tool
             break
 
@@ -141,10 +141,10 @@ async def test_invoke_users_list_command(basic_mcp_session):
     result = await basic_mcp_session.list_tools()
     tools = result.tools
 
-    # Find the users.list command
+    # Find the users_list command
     users_list_tool = None
     for tool in tools:
-        if "users.list" in tool.name.lower():
+        if "users_list" in tool.name.lower():
             users_list_tool = tool
             break
 
@@ -244,7 +244,7 @@ async def test_advanced_server_tools(advanced_mcp_session):
     tools = result.tools
     assert len(tools) > 0
 
-    # Find the config.set command
+    # Find the config_set command
     config_set_tool = None
     for tool in tools:
         if "config.set" in tool.name.lower():
@@ -324,7 +324,7 @@ async def test_invoke_advanced_commands(advanced_mcp_session):
     result = await advanced_mcp_session.list_tools()
     tools = result.tools
 
-    # Find the config.set command
+    # Find the config_set command
     config_set_tool = None
     for tool in tools:
         if "config.set" in tool.name.lower():