feat: add preliminary framework to handle requests

add basic logic to handle http requests and dispatch to gdb handlers

Signed-off-by: Lix Zhou 

Author: pansila

.cursorrules

@@ -4,4 +4,24 @@ version = "0.1.0"
 edition = "2024"
 
 [dependencies]
-tokio = "1.44.1"
+axum = "0.8"
+tokio = { version = "1.44", features = ["full"] }
+tower = "0.4"
+tower-http = { version = "0.5", features = ["cors", "trace"] }
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+tracing-appender = "0.2"
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+thiserror = "1.0"
+async-trait = "0.1"
+tokio-stream = "0.1"
+futures = "0.3"
+anyhow = "1.0"
+regex = "1.10"
+uuid = { version = "1.7", features = ["v4", "serde"] }
+clap = { version = "4.5",  features = ["derive"] }
+dotenv = "0.15"
+mcp-core = { version = "0.1",  features = ["sse"] }
+mcp-core-macros = "0.1"
+schemars = "0.8"

Cargo.lock

@@ -1,2 +1,60 @@
-# mcp_server_gdb
-MCP Server to expose the GDB debugging capabilities
+# MCP Server GDB
+
+A GDB/MI protocol server based on the Axum framework, providing RESTful API interfaces for remote application debugging.
+
+## Features
+
+- Create and manage GDB debug sessions
+- Send GDB/MI commands and get responses
+- Set and manage breakpoints
+- View stack information and variables
+- Control program execution (run, pause, step, etc.)
+- Support concurrent multi-session debugging
+
+## API Endpoints
+
+### Session Management
+
+- `GET /api/sessions` - Get all sessions
+- `POST /api/sessions` - Create new session
+- `GET /api/sessions/:session_id` - Get specific session
+- `DELETE /api/sessions/:session_id` - Close session
+
+### Debug Control
+
+- `POST /api/sessions/:session_id/command` - Send GDB command
+- `POST /api/sessions/:session_id/start` - Start debugging
+- `POST /api/sessions/:session_id/stop` - Stop debugging
+- `POST /api/sessions/:session_id/continue` - Continue execution
+- `POST /api/sessions/:session_id/step` - Step execution
+- `POST /api/sessions/:session_id/next` - Next execution
+
+### Breakpoint Management
+
+- `GET /api/sessions/:session_id/breakpoints` - Get breakpoint list
+- `POST /api/sessions/:session_id/breakpoints` - Set breakpoint
+- `DELETE /api/sessions/:session_id/breakpoints/:breakpoint_id` - Delete breakpoint
+
+### Debug Information
+
+- `GET /api/sessions/:session_id/stack` - Get stack information
+- `GET /api/sessions/:session_id/variables/:frame_id` - Get local variables
+
+## Usage
+
+1. Install Rust and Cargo
+2. Clone this repository
+3. Run `cargo run` to start the server
+4. Default server runs on `http://localhost:8080`
+
+## Configuration
+
+You can adjust server configuration by modifying the `src/config.rs` file:
+
+- Server port
+- GDB path
+- Temporary file directory
+
+## License
+
+MIT

Cargo.toml

@@ -0,0 +1,22 @@
+/// Server Configuration
+pub struct Config {
+    /// Server port
+    pub server_port: u16,
+    /// GDB path
+    pub gdb_path: String,
+    /// Temporary file directory
+    pub temp_dir: String,
+}
+
+impl Default for Config {
+    fn default() -> Self {
+        Self {
+            server_port: std::env::var("SERVER_PORT")
+                .unwrap_or_else(|_| "8080".to_string())
+                .parse()
+                .expect("Invalid server port"),
+            gdb_path: std::env::var("GDB_PATH").unwrap_or_else(|_| "gdb".to_string()),
+            temp_dir: std::env::temp_dir().to_string_lossy().to_string(),
+        }
+    }
+}

README.md

@@ -0,0 +1,50 @@
+use axum::{
+    Json,
+    http::StatusCode,
+    response::{IntoResponse, Response},
+};
+use serde_json::json;
+use thiserror::Error;
+
+/// Application error types
+#[derive(Error, Debug)]
+pub enum AppError {
+    #[error("GDB error: {0}")]
+    GDBError(String),
+
+    #[error("Parse error: {0}")]
+    ParseError(String),
+
+    #[error("IO error: {0}")]
+    IoError(#[from] std::io::Error),
+
+    #[error("Resource not found: {0}")]
+    NotFound(String),
+
+    #[error("Internal server error: {0}")]
+    InternalServerError(String),
+}
+
+impl IntoResponse for AppError {
+    fn into_response(self) -> Response {
+        let (status, error_message) = match self {
+            AppError::GDBError(msg) => (StatusCode::BAD_REQUEST, msg),
+            AppError::ParseError(msg) => (StatusCode::BAD_REQUEST, msg),
+            AppError::IoError(err) => (StatusCode::INTERNAL_SERVER_ERROR, err.to_string()),
+            AppError::NotFound(msg) => (StatusCode::NOT_FOUND, msg),
+            AppError::InternalServerError(msg) => (StatusCode::INTERNAL_SERVER_ERROR, msg),
+        };
+
+        let body = Json(json!({
+            "error": {
+                "message": error_message,
+                "code": status.as_u16()
+            }
+        }));
+
+        (status, body).into_response()
+    }
+}
+
+/// Application result type
+pub type AppResult<T> = Result<T, AppError>;