FastAPI-MCP增强工具

from fastapi_mcp_enhanced import SchemaAnalyzer, ToolQualityAnalyzer, AuthAnalyzer

# Analyze an OpenAPI schema
analyzer = SchemaAnalyzer(openapi_schema)
summary = analyzer.summarize()
# {'total_endpoints': 12, 'methods': {'GET': 5, 'POST': 4, ...}, 'crud_coverage': 0.75}

complexity = analyzer.endpoint_complexity("/users/{id}", "get")
# {'path_params': 1, 'query_params': 0, 'has_body': False, 'score': 2}

crud = analyzer.crud_analysis()
# {'resources': {'users': {'create': True, 'read': True, 'update': True, 'delete': False}}}

# Evaluate MCP tool quality
quality = ToolQualityAnalyzer(openapi_schema)
report = quality.full_report()
# {'name_quality': 0.9, 'description_quality': 0.85, 'schema_quality': 0.92, ...}

# Analyze auth configuration
auth = AuthAnalyzer(openapi_schema)
schemes = auth.detect_security_schemes()
coverage = auth.auth_coverage()
recommendations = auth.recommendations()

from fastapi_mcp_enhanced import EndpointFilter, ToolGrouper, ConfigGenerator, RoutingAnalyzer

# Filter endpoints by tags, methods, or patterns
f = EndpointFilter(openapi_schema)
crud_only = f.filter_by_methods(["get", "post", "put", "delete"])
admin_endpoints = f.filter_by_tags(["admin"])
user_endpoints = f.filter_by_pattern("/users/*")

# Group tools for organized exposure
grouper = ToolGrouper(openapi_schema)
by_tag = grouper.group_by_tag()
by_resource = grouper.group_by_resource()
namespaces = grouper.suggest_namespaces()

# Generate FastApiMCP configurations
gen = ConfigGenerator(openapi_schema)
config = gen.generate_config(include_tags=["public"], exclude_methods=["delete"])
code = gen.format_as_python(config)
# Outputs ready-to-use FastApiMCP(...) Python code

# Analyze routing quality
ra = RoutingAnalyzer(openapi_schema)
coverage = ra.coverage_analysis(include_operations=["getUsers", "createUser"])
conflicts = ra.detect_conflicts()
suggestions = ra.improvement_suggestions()

from fastapi_mcp_enhanced import SchemaMetrics, ComplexityEstimator, TransportComparator

# Measure schema metrics
metrics = SchemaMetrics(openapi_schema)
stats = metrics.summary()
# {'endpoints': 15, 'parameters': 42, 'schemas': 8, 'estimated_tools': 15}

filtered = metrics.estimate_tool_count(include_tags=["public"])
param_stats = metrics.parameter_statistics()

# Estimate endpoint complexity
estimator = ComplexityEstimator(openapi_schema)
scores = estimator.all_complexities()
# {'/users': 3.2, '/users/{id}/orders': 6.8, ...}

ranking = estimator.complexity_ranking()
hotspots = estimator.identify_hotspots(threshold=7.0)

# Compare SSE vs HTTP transports
comparator = TransportComparator()
comparison = comparator.compare()
recommendation = comparator.recommend(use_case="production")

# Full conversion benchmark
from fastapi_mcp_enhanced import ConversionBenchmark, ToolSizeEstimator
bench = ConversionBenchmark(openapi_schema)
report = bench.full_report()
strategies = bench.compare_filter_strategies()

# Check MCP tool size limits
sizer = ToolSizeEstimator(openapi_schema)
sizes = sizer.estimate_total_tools_size()
limits = sizer.check_limits(max_tools=50, max_total_size_kb=512)
optimizations = sizer.optimize_for_limits(max_total_size_kb=256)

git clone https://github.com/Rlin1027/fastapi-mcp-enhanced.git
cd fastapi-mcp-enhanced
pip install -e .  # Install original fastapi-mcp

python3 -m pytest tests/test_analysis.py tests/test_routing.py tests/test_benchmark.py -v