#!/usr/bin/env python3
# debug/debug_mcp_server.py
"""
Enhanced debug script to check what methods are available on the MCPServer object
and analyze the complete chuk-mcp library structure.
"""
import sys
import inspect
def analyze_mcp_server():
"""Analyze the MCPServer class in detail."""
try:
from chuk_mcp.server import MCPServer
from chuk_mcp.protocol.types import ServerCapabilities
print("🔍 Inspecting MCPServer class:")
print("=" * 50)
# Create a server instance
server = MCPServer(name="test", version="1.0.0")
# Get all methods and attributes
methods = []
attributes = []
for name in dir(server):
if not name.startswith('_'):
obj = getattr(server, name)
if callable(obj):
methods.append(name)
else:
attributes.append(name)
print("📋 Available Methods:")
for method in sorted(methods):
try:
sig = inspect.signature(getattr(server, method))
print(f" • {method}{sig}")
except:
print(f" • {method}()")
print(f"\n📋 Available Attributes:")
for attr in sorted(attributes):
attr_obj = getattr(server, attr)
print(f" • {attr}: {type(attr_obj)}")
# Check for specific methods we need
required_methods = ['run_stdio', 'run', 'start', 'serve', 'register_tool', 'register_resource', 'register_prompt']
print(f"\n🔍 Checking for required methods:")
for method in required_methods:
if hasattr(server, method):
print(f" ✅ {method} - Available")
try:
sig = inspect.signature(getattr(server, method))
print(f" Signature: {method}{sig}")
except:
pass
else:
print(f" ❌ {method} - Missing")
# Check the server's class hierarchy
print(f"\n🏗️ Class hierarchy:")
for cls in server.__class__.__mro__:
print(f" • {cls}")
# Check if there are any run-like methods
print(f"\n🏃 Run-like methods:")
run_methods = []
for method in methods:
if any(keyword in method.lower() for keyword in ['run', 'start', 'serve', 'execute', 'handle']):
run_methods.append(method)
print(f" • {method}")
if not run_methods:
print(" 📝 No run-like methods found")
# Analyze the protocol handler in detail
print(f"\n🔍 Protocol Handler Analysis:")
if hasattr(server, 'protocol_handler'):
handler = server.protocol_handler
print(f" • Type: {type(handler)}")
handler_methods = []
for name in dir(handler):
if not name.startswith('_') and callable(getattr(handler, name)):
handler_methods.append(name)
print(f" • Methods: {', '.join(sorted(handler_methods))}")
# Check if handle_message is async
if hasattr(handler, 'handle_message'):
handle_msg = getattr(handler, 'handle_message')
is_async = inspect.iscoroutinefunction(handle_msg)
print(f" • handle_message is async: {is_async}")
try:
sig = inspect.signature(handle_msg)
print(f" • handle_message signature: {sig}")
except:
pass
return True
except ImportError as e:
print(f"❌ Failed to import chuk_mcp: {e}")
return False
except Exception as e:
print(f"❌ Error inspecting MCPServer: {e}")
import traceback
traceback.print_exc()
return False
def analyze_chuk_mcp_structure():
"""Analyze the complete chuk_mcp library structure."""
print(f"\n📦 Analyzing chuk_mcp library structure:")
print("=" * 50)
try:
import chuk_mcp
print(f"🔍 chuk_mcp version: {getattr(chuk_mcp, '__version__', 'unknown')}")
# Get top-level items
top_level = {}
for attr in dir(chuk_mcp):
if not attr.startswith('_'):
obj = getattr(chuk_mcp, attr)
obj_type = type(obj).__name__
if obj_type not in top_level:
top_level[obj_type] = []
top_level[obj_type].append(attr)
for obj_type, items in sorted(top_level.items()):
print(f"\n📋 {obj_type}s ({len(items)}):")
for item in sorted(items)[:10]: # Show first 10
print(f" • {item}")
if len(items) > 10:
print(f" ... and {len(items) - 10} more")
# Check for transport-related items
print(f"\n🚛 Transport-related items:")
transport_items = []
for attr in dir(chuk_mcp):
if any(keyword in attr.lower() for keyword in ['transport', 'stdio', 'http', 'client', 'server']):
obj = getattr(chuk_mcp, attr)
transport_items.append((attr, type(obj)))
if transport_items:
for attr, obj_type in transport_items:
print(f" • {attr}: {obj_type}")
else:
print(" 📝 No obvious transport items found at top level")
# Check submodules
print(f"\n📂 Checking for submodules:")
potential_submodules = ['server', 'client', 'transport', 'protocol', 'stdio']
for submodule in potential_submodules:
if hasattr(chuk_mcp, submodule):
sub = getattr(chuk_mcp, submodule)
if hasattr(sub, '__file__') or hasattr(sub, '__path__'):
print(f" ✅ {submodule}: {type(sub)}")
# List contents of server module specifically
if submodule == 'server':
print(f" 📋 server module contents:")
for item in dir(sub):
if not item.startswith('_'):
print(f" • {item}: {type(getattr(sub, item))}")
else:
print(f" ⚠️ {submodule}: {type(sub)} (not a module)")
else:
print(f" ❌ {submodule}: Not found")
return True
except Exception as e:
print(f"❌ Error analyzing chuk_mcp: {e}")
return False
def check_working_solution():
"""Document our current working solution."""
print(f"\n✅ Current Working Solution Summary:")
print("=" * 50)
print(f"📊 What works:")
print(f" • MCPServer.register_tool() - ✅ Working")
print(f" • MCPServer.register_resource() - ✅ Working")
print(f" • MCPServer.protocol_handler.handle_message() - ✅ Working (async)")
print(f" • Manual stdio handling - ✅ Working")
print(f" • 286 mathematical functions - ✅ Working")
print(f" • Async function execution - ✅ Working")
print(f" • JSON-RPC communication - ✅ Working")
print(f"\n📊 What's missing/not working:")
print(f" • MCPServer.run_stdio() - ❌ Missing")
print(f" • MCPServer.register_prompt() - ❌ Missing")
print(f" • Built-in transport handling - ❌ Missing")
print(f"\n🔧 Our workarounds:")
print(f" • Manual stdio loop instead of run_stdio()")
print(f" • Skip prompt registration (method doesn't exist)")
print(f" • Direct module access for math functions (get_mcp_functions returns 0)")
print(f" • Proper async/await handling for protocol_handler.handle_message()")
print(f"\n🎯 Result:")
print(f" • Fully functional MCP Math Server with 286 functions")
print(f" • Compatible with chuk-mcp v0.4.0")
print(f" • Real mathematical computations working correctly")
def main():
"""Main analysis function."""
print("🧮 Enhanced chuk-mcp Library Analysis")
print("=" * 60)
# Analyze MCPServer
server_success = analyze_mcp_server()
# Analyze overall library structure
lib_success = analyze_chuk_mcp_structure()
# Document our working solution
check_working_solution()
print(f"\n📋 Analysis Summary:")
print(f" • MCPServer analysis: {'✅ Success' if server_success else '❌ Failed'}")
print(f" • Library analysis: {'✅ Success' if lib_success else '❌ Failed'}")
print(f" • Server implementation: ✅ Working with 286 functions")
if __name__ == "__main__":
main()
