Godot 4 Runtime MCP Server

using Refit; using McpServer.Models; namespace McpServer.Services; /// <summary> /// Godot HTTP API 接口 - 每个方法独立的 HTTP 端点 /// </summary> public interface IGodotApi { // ========== 场景树操作 ========== [Post("/get_scene_tree")] Task<GodotResponse> GetSceneTreeAsync([Body] SceneTreeRequest request); [Post("/get_node_info")] Task<GodotResponse> GetNodeInfoAsync([Body] NodePathRequest request); [Post("/create_node")] Task<GodotResponse> CreateNodeAsync([Body] CreateNodeRequest request); [Post("/delete_node")] Task<GodotResponse> DeleteNodeAsync([Body] NodePathRequest request); [Post("/load_scene")] Task<GodotResponse> LoadSceneAsync([Body] ScenePathRequest request); // ========== 属性操作 ========== [Post("/get_property")] Task<GodotResponse> GetPropertyAsync([Body] PropertyRequest request); [Post("/set_property")] Task<GodotResponse> SetPropertyAsync([Body] SetPropertyRequest request); [Post("/list_properties")] Task<GodotResponse> ListPropertiesAsync([Body] NodePathRequest request); // ========== 方法调用 ========== [Post("/call_method")] Task<GodotResponse> CallMethodAsync([Body] CallMethodRequest request); [Post("/list_methods")] Task<GodotResponse> ListMethodsAsync([Body] NodePathRequest request); // ========== 脚本和资源 ========== [Post("/execute_csharp")] Task<GodotResponse> ExecuteCSharpAsync([Body] CodeRequest request); [Post("/get_global_variables")] Task<GodotResponse> GetGlobalVariablesAsync(); [Post("/get_resource_info")] Task<GodotResponse> GetResourceInfoAsync([Body] ResourcePathRequest request); [Post("/list_resources")] Task<GodotResponse> ListResourcesAsync([Body] ListResourcesRequest request); [Post("/load_resource")] Task<GodotResponse> LoadResourceAsync([Body] ResourcePathRequest request); // ========== 调试工具 ========== [Post("/get_performance_stats")] Task<GodotResponse> GetPerformanceStatsAsync(); [Post("/get_logs")] Task<GodotResponse> GetLogsAsync([Body] LogsRequest request); [Post("/take_screenshot")] Task<GodotResponse> TakeScreenshotAsync([Body] ScreenshotRequest request); [Post("/get_time")] Task<GodotResponse> GetTimeAsync(); // ========== 扩展场景树查询 ========== [Post("/get_node_children")] Task<GodotResponse> GetNodeChildrenAsync([Body] NodePathRequest request); [Post("/get_node_parent")] Task<GodotResponse> GetNodeParentAsync([Body] NodePathRequest request); [Post("/find_nodes_by_type")] Task<GodotResponse> FindNodesByTypeAsync([Body] FindNodesRequest request); [Post("/find_nodes_by_name")] Task<GodotResponse> FindNodesByNameAsync([Body] FindNodesRequest request); [Post("/find_nodes_by_group")] Task<GodotResponse> FindNodesByGroupAsync([Body] FindNodesRequest request); [Post("/get_node_ancestors")] Task<GodotResponse> GetNodeAncestorsAsync([Body] AncestorsRequest request); [Post("/get_scene_tree_stats")] Task<GodotResponse> GetSceneTreeStatsAsync([Body] NodePathRequest request); [Post("/node_exists")] Task<GodotResponse> NodeExistsAsync([Body] NodePathRequest request); [Post("/get_node_subtree")] Task<GodotResponse> GetNodeSubtreeAsync([Body] SubtreeRequest request); [Post("/search_nodes")] Task<GodotResponse> SearchNodesAsync([Body] FindNodesRequest request); [Post("/get_node_context")] Task<GodotResponse> GetNodeContextAsync([Body] NodeContextRequest request); // ========== 简化场景树 ========== [Post("/get_scene_tree_simple")] Task<GodotResponse> GetSceneTreeSimpleAsync([Body] SimpleTreeRequest request); // ========== 信号系统 ========== [Post("/get_node_signals")] Task<GodotResponse> GetNodeSignalsAsync([Body] NodePathRequest request); [Post("/get_signal_connections")] Task<GodotResponse> GetSignalConnectionsAsync([Body] SignalConnectionRequest request); [Post("/connect_signal")] Task<GodotResponse> ConnectSignalAsync([Body] SignalConnectionRequest request); [Post("/disconnect_signal")] Task<GodotResponse> DisconnectSignalAsync([Body] SignalConnectionRequest request); [Post("/emit_signal")] Task<GodotResponse> EmitSignalAsync([Body] SignalEmitRequest request); [Post("/start_signal_monitoring")] Task<GodotResponse> StartSignalMonitoringAsync([Body] SignalMonitorRequest request); [Post("/stop_signal_monitoring")] Task<GodotResponse> StopSignalMonitoringAsync(); [Post("/get_signal_events")] Task<GodotResponse> GetSignalEventsAsync([Body] SignalEventQueryRequest request); [Post("/clear_signal_events")] Task<GodotResponse> ClearSignalEventsAsync(); // ========== 增强日志系统 ========== [Post("/get_logs_filtered")] Task<GodotResponse> GetLogsFilteredAsync([Body] LogFilterRequest request); [Post("/get_log_stats")] Task<GodotResponse> GetLogStatsAsync(); [Post("/export_logs")] Task<GodotResponse> ExportLogsAsync([Body] LogExportRequest request); [Post("/clear_logs")] Task<GodotResponse> ClearLogsAsync(); [Post("/add_custom_log")] Task<GodotResponse> AddCustomLogAsync([Body] CustomLogRequest request); }