Skip to content

armgit / dbx

Public Imported from GitHub
0

25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。

41.0 KB
Raw Blame
use std::{collections::HashMap, sync::Arc, sync::Mutex};

use async_trait::async_trait;
use dbx_core::{
    agent_events::ToolResult,
    agent_tools::AgentSqlPermissions,
    models::connection::{ConnectionConfig, DatabaseType},
    storage::McpGlobalPolicy,
};
use dbx_mcp::{with_legacy_discovery_fallback, DbxBackend, DbxMcpServer, McpScope};
use rmcp::{
    model::{CallToolRequestParams, ReadResourceRequestParams, ResourceContents},
    ServiceExt,
};
use serde_json::{json, Map, Value};
use tokio::io::{AsyncBufReadExt, AsyncWriteExt, BufReader, DuplexStream};

struct PolicyBackend {
    policy: McpGlobalPolicy,
    connections: Vec<ConnectionConfig>,
    group_paths: Result<HashMap<String, Vec<String>>, String>,
}

#[async_trait]
impl DbxBackend for PolicyBackend {
    async fn load_mcp_global_policy(&self) -> Result<McpGlobalPolicy, String> {
        Ok(self.policy.clone())
    }

    async fn load_connections(&self) -> Result<Vec<ConnectionConfig>, String> {
        Ok(self.connections.clone())
    }

    async fn list_databases(&self, _connection: &ConnectionConfig) -> Result<Vec<String>, String> {
        Ok(vec!["analytics".to_string(), "reporting".to_string()])
    }

    async fn list_tables(
        &self,
        _connection: &ConnectionConfig,
        _database: &str,
        _schema: &str,
    ) -> Result<Vec<dbx_core::db::TableInfo>, String> {
        Ok(vec![dbx_core::db::TableInfo {
            name: "orders".to_string(),
            table_type: "TABLE".to_string(),
            valid: Some(true),
            comment: Some("Customer orders".to_string()),
            parent_schema: None,
            parent_name: None,
        }])
    }

    async fn get_columns(
        &self,
        _connection: &ConnectionConfig,
        _database: &str,
        _schema: &str,
        _table: &str,
    ) -> Result<Vec<dbx_core::db::ColumnInfo>, String> {
        Ok(vec![dbx_core::db::ColumnInfo {
            name: "id".to_string(),
            data_type: "INTEGER".to_string(),
            is_nullable: false,
            is_primary_key: true,
            ..Default::default()
        }])
    }

    async fn load_connection_group_paths(&self) -> Result<HashMap<String, Vec<String>>, String> {
        self.group_paths.clone()
    }

    async fn execute_agent_tool(
        &self,
        _connection: &ConnectionConfig,
        _database: &str,
        tool_name: &str,
        _arguments: Value,
        _permissions: AgentSqlPermissions,
    ) -> ToolResult {
        ToolResult {
            tool_call_id: "policy-test".to_string(),
            tool_name: tool_name.to_string(),
            content: "query should have been blocked".to_string(),
            is_error: true,
            explain_data: None,
        }
    }

    async fn add_connection_for_mcp(&self, config: ConnectionConfig) -> Result<ConnectionConfig, String> {
        Ok(config)
    }

    async fn duplicate_connection_for_mcp(
        &self,
        _source_id: &str,
        _copy_id: &str,
        _copy_name: &str,
    ) -> Result<ConnectionConfig, String> {
        Err("not exercised".to_string())
    }

    async fn remove_connection_for_mcp(&self, _connection_id: &str) -> Result<bool, String> {
        Ok(true)
    }
}

struct CapturingBackend {
    policy: McpGlobalPolicy,
    connections: Vec<ConnectionConfig>,
    /// Records the arguments passed to `execute_agent_tool` so tests can assert
    /// what the server injected (e.g. `timeout_secs` from the MCP policy).
    calls: Mutex<Vec<Value>>,
}

#[async_trait]
impl DbxBackend for CapturingBackend {
    #[cfg(feature = "mq-admin")]
    async fn peek_messages(
        &self,
        connection: &ConnectionConfig,
        topic: dbx_core::mq::TopicRef,
        count: u32,
        options: dbx_core::mq::PeekMessagesOptions,
    ) -> Result<dbx_core::mq::PeekMessagesResult, String> {
        self.calls
            .lock()
            .unwrap()
            .push(json!({"connection":connection.id, "topic":topic.topic, "count":count, "options":options}));
        Ok(dbx_core::mq::PeekMessagesResult::complete(vec![dbx_core::mq::PeekedMessage {
            payload_base64: "aGk=".into(),
            payload_text: Some("hi".into()),
            ..Default::default()
        }]))
    }

    async fn load_mcp_global_policy(&self) -> Result<McpGlobalPolicy, String> {
        Ok(self.policy.clone())
    }

    async fn load_connections(&self) -> Result<Vec<ConnectionConfig>, String> {
        Ok(self.connections.clone())
    }

    async fn execute_agent_tool(
        &self,
        _connection: &ConnectionConfig,
        _database: &str,
        tool_name: &str,
        arguments: Value,
        _permissions: AgentSqlPermissions,
    ) -> ToolResult {
        self.calls.lock().expect("lock captures").push(arguments);
        ToolResult {
            tool_call_id: "capture-test".to_string(),
            tool_name: tool_name.to_string(),
            content: "ok".to_string(),
            is_error: false,
            explain_data: None,
        }
    }

    async fn add_connection_for_mcp(&self, config: ConnectionConfig) -> Result<ConnectionConfig, String> {
        Ok(config)
    }

    async fn duplicate_connection_for_mcp(
        &self,
        _source_id: &str,
        _copy_id: &str,
        _copy_name: &str,
    ) -> Result<ConnectionConfig, String> {
        Err("not exercised".to_string())
    }

    async fn remove_connection_for_mcp(&self, _connection_id: &str) -> Result<bool, String> {
        Ok(true)
    }
}

/// Drives one `dbx_execute_query` call against a `CapturingBackend`, returning
/// the captured arguments for assertion.
async fn captured_query_arguments(backend: Arc<CapturingBackend>, sql_arguments: Value) -> Vec<Value> {
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(backend.clone(), McpScope::default(), false);
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");
    let _ = client
        .peer()
        .call_tool(
            CallToolRequestParams::new("dbx_execute_query")
                .with_arguments(sql_arguments.as_object().cloned().unwrap_or_else(Map::new)),
        )
        .await
        .expect("call execute_query");
    client.cancel().await.expect("close MCP client");
    server_task.abort();
    backend.calls.lock().expect("lock captures").clone()
}

/// Regression for the MCP global query-timeout override: the server must inject
/// `timeout_secs` into the `dbx_execute_query` arguments whenever the persisted
/// policy carries a value, and must NOT inject it when the policy inherits the
/// connection (None). This is the native boundary that turns the settings-page
/// value into a per-query argument (server.rs `if let Some(secs) = ...`).
#[tokio::test]
async fn execute_query_injects_and_omits_timeout_secs_from_policy() {
    // Case 1: a positive policy timeout is injected on every call.
    let backend = Arc::new(CapturingBackend {
        policy: McpGlobalPolicy {
            read_only: false,
            allow_dangerous_sql: false,
            allowed_connection_ids: None,
            query_timeout_secs: Some(300),
            ..Default::default()
        },
        connections: vec![test_connection("scoped", "shared-db")],
        calls: Mutex::new(Vec::new()),
    });
    let captured = captured_query_arguments(backend, json!({ "connection_id": "scoped", "sql": "SELECT 1" })).await;
    assert_eq!(captured.len(), 1, "expected one captured execute_query call");
    assert_eq!(captured[0]["timeout_secs"], json!(300), "policy timeout must be injected");

    // Case 2: an inheriting policy (None) omits the key so the connection-level
    // default is honoured rather than overridden by a stale value.
    let backend = Arc::new(CapturingBackend {
        policy: McpGlobalPolicy {
            read_only: false,
            allow_dangerous_sql: false,
            allowed_connection_ids: None,
            query_timeout_secs: None,
            ..Default::default()
        },
        connections: vec![test_connection("scoped", "shared-db")],
        calls: Mutex::new(Vec::new()),
    });
    let captured = captured_query_arguments(backend, json!({ "connection_id": "scoped", "sql": "SELECT 1" })).await;
    assert_eq!(captured.len(), 1, "expected one captured execute_query call");
    assert!(
        captured[0].get("timeout_secs").is_none(),
        "no timeout_secs must be injected when the policy inherits the connection: {}",
        captured[0]
    );
}

/// The client-facing field is `max_rows`. Only this rmcp-level test proves the
/// published name survives tool-call serialization and that clamping happens at
/// the native boundary; the in-process tests assert the internal `limit`
/// argument directly and cannot catch a name mismatch.
#[tokio::test]
async fn execute_query_forwards_client_max_rows() {
    let cases = [
        (json!({ "connection_id": "scoped", "sql": "SELECT 1" }), 100_u64),
        (json!({ "connection_id": "scoped", "sql": "SELECT 1", "max_rows": 500 }), 500),
        (json!({ "connection_id": "scoped", "sql": "SELECT 1", "max_rows": 100000 }), 1000),
        (json!({ "connection_id": "scoped", "sql": "SELECT 1", "max_rows": 0 }), 1),
    ];
    for (request, expected) in cases {
        let backend = Arc::new(CapturingBackend {
            policy: McpGlobalPolicy::default(),
            connections: vec![test_connection("scoped", "shared-db")],
            calls: Mutex::new(Vec::new()),
        });
        let captured = captured_query_arguments(backend, request.clone()).await;
        assert_eq!(captured.len(), 1, "expected one captured execute_query call");
        assert_eq!(captured[0]["limit"], json!(expected), "max_rows in {request} must map to limit");
    }
}

fn test_connection(id: &str, name: &str) -> ConnectionConfig {
    serde_json::from_value(json!({
        "id": id,
        "name": name,
        "db_type": "sqlite",
        "host": "",
        "port": 0,
        "username": "",
        "password": "",
        "database": ":memory:",
        "ssl": false
    }))
    .expect("test connection")
}

fn catalog_connections() -> Vec<ConnectionConfig> {
    DatabaseType::ALL
        .iter()
        .enumerate()
        .map(|(index, db_type)| {
            serde_json::from_value(json!({
                "id": format!("catalog-{index}"),
                "name": format!("catalog-{db_type:?}"),
                "db_type": db_type,
                "host": "",
                "port": 0,
                "username": "",
                "password": "",
                "database": "",
                "ssl": false
            }))
            .expect("catalog test connection")
        })
        .collect()
}

fn mysql_connection(id: &str, name: &str) -> ConnectionConfig {
    serde_json::from_value(json!({
        "id": id,
        "name": name,
        "db_type": "mysql",
        "host": "localhost",
        "port": 3306,
        "username": "tester",
        "password": "",
        "database": "reporting",
        "ssl": false
    }))
    .expect("test MySQL connection")
}

fn postgres_connection(id: &str, name: &str) -> ConnectionConfig {
    serde_json::from_value(json!({
        "id": id,
        "name": name,
        "db_type": "postgres",
        "host": "localhost",
        "port": 5432,
        "username": "tester",
        "password": "",
        "database": "reporting",
        "ssl": false
    }))
    .expect("test PostgreSQL connection")
}

async fn stdio_request(stream: &mut BufReader<DuplexStream>, id: i64, method: &str, params: Value) -> Value {
    let request = json!({"jsonrpc": "2.0", "id": id, "method": method, "params": params});
    stream.get_mut().write_all(format!("{request}\n").as_bytes()).await.unwrap();
    let mut line = String::new();
    tokio::time::timeout(std::time::Duration::from_secs(5), stream.read_line(&mut line))
        .await
        .expect("stdio response timed out")
        .expect("read stdio response");
    let response: Value = serde_json::from_str(&line).expect("JSON-RPC response");
    assert_eq!(response["id"], id);
    assert!(response.get("error").is_none(), "{method}: {response}");
    response["result"].clone()
}

#[tokio::test]
async fn list_results_include_complete_discriminator_for_modern_stdio_clients() {
    let meta = json!({
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientCapabilities": {},
        "io.modelcontextprotocol/clientInfo": {"name": "protocol-test", "version": "0"}
    });
    for hide_tools in [false, true] {
        let backend = PolicyBackend {
            policy: McpGlobalPolicy { allowed_tool_names: hide_tools.then(Vec::new), ..Default::default() },
            connections: hide_tools.then(Vec::new).unwrap_or_else(|| vec![test_connection("local", "local-db")]),
            group_paths: Ok(HashMap::new()),
        };
        let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
        let server = DbxMcpServer::with_runtime_options(Arc::new(backend), McpScope::default(), false);
        let server_task =
            tokio::spawn(async move { server.serve(with_legacy_discovery_fallback(server_transport)).await });
        let mut client = BufReader::new(client_transport);
        let discovery = stdio_request(&mut client, 1, "server/discover", json!({"_meta": meta})).await;
        assert!(discovery["supportedVersions"].as_array().unwrap().contains(&json!("2026-07-28")));

        for (index, (method, items)) in [
            ("tools/list", "tools"),
            ("resources/list", "resources"),
            ("resources/templates/list", "resourceTemplates"),
        ]
        .into_iter()
        .enumerate()
        {
            let result = stdio_request(&mut client, index as i64 + 2, method, json!({"_meta": meta})).await;
            assert_eq!(result["resultType"], "complete", "{method} requires resultType on 2026-07-28");
            assert_eq!(result["ttlMs"], 0, "{method}");
            assert_eq!(result["cacheScope"], "private", "{method}");
            assert!(result.get("nextCursor").is_none(), "{method}");
            assert_eq!(result[items].as_array().unwrap().is_empty(), hide_tools, "{method}");
        }

        drop(client);
        server_task.abort();
    }
}

#[tokio::test]
async fn list_results_preserve_legacy_stdio_shapes_after_initialize() {
    for requested_version in ["2025-03-26", "2025-06-18", "2025-11-25", "2026-07-28"] {
        let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
        let server = DbxMcpServer::with_runtime_options(
            Arc::new(PolicyBackend {
                policy: McpGlobalPolicy::default(),
                connections: vec![test_connection("local", "local-db")],
                group_paths: Ok(HashMap::new()),
            }),
            McpScope::default(),
            false,
        );
        let server_task =
            tokio::spawn(async move { server.serve(with_legacy_discovery_fallback(server_transport)).await });
        let mut client = BufReader::new(client_transport);
        let initialized = stdio_request(
            &mut client,
            1,
            "initialize",
            json!({
                "protocolVersion": requested_version,
                "capabilities": {},
                "clientInfo": {"name": "protocol-test", "version": "0"}
            }),
        )
        .await;
        let negotiated_version = if requested_version == "2026-07-28" { "2025-11-25" } else { requested_version };
        assert_eq!(initialized["protocolVersion"], negotiated_version);
        client.get_mut().write_all(b"{\"jsonrpc\":\"2.0\",\"method\":\"notifications/initialized\"}\n").await.unwrap();

        for (index, (method, items)) in [
            ("tools/list", "tools"),
            ("resources/list", "resources"),
            ("resources/templates/list", "resourceTemplates"),
        ]
        .into_iter()
        .enumerate()
        {
            let result = stdio_request(&mut client, index as i64 + 2, method, json!({})).await;
            for field in ["resultType", "ttlMs", "cacheScope", "nextCursor"] {
                assert!(result.get(field).is_none(), "{method} on {negotiated_version} unexpectedly includes {field}");
            }
            assert!(!result[items].as_array().unwrap().is_empty(), "{method}");
        }

        drop(client);
        server_task.abort();
    }
}

#[tokio::test]
async fn initializes_lists_tools_and_calls_a_tool() {
    let connections = catalog_connections();
    // The full catalog includes Salesforce writes only after an explicit
    // per-connection DML opt-in; the global SQL ceiling is not that consent.
    let connection_policies = connections
        .iter()
        .filter(|connection| connection.db_type == DatabaseType::Salesforce)
        .map(|connection| {
            serde_json::from_value(json!({
                "connectionId": connection.id,
                "executionModeConfigured": false,
                "allowSalesforceDml": true
            }))
            .expect("Salesforce catalog policy")
        })
        .collect();
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(
        Arc::new(PolicyBackend {
            policy: McpGlobalPolicy { allow_dangerous_sql: true, connection_policies, ..Default::default() },
            connections,
            group_paths: Ok(HashMap::new()),
        }),
        McpScope::default(),
        false,
    );
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");

    let tools = client.peer().list_tools(None).await.expect("list tools");
    let names = tools.tools.iter().map(|tool| tool.name.as_ref()).collect::<Vec<_>>();
    // Includes the 22 product-provider tools (14 Nacos + 8 Consul).
    #[cfg(feature = "mq-admin")]
    assert_eq!(names.len(), 47);
    #[cfg(not(feature = "mq-admin"))]
    assert_eq!(names.len(), 45);
    #[cfg(feature = "mq-admin")]
    assert!(names.contains(&"dbx_peek_messages"));
    #[cfg(not(feature = "mq-admin"))]
    assert!(!names.contains(&"dbx_peek_messages"));
    assert!(names.contains(&"dbx_list_connections"));
    assert!(names.contains(&"dbx_list_databases"));
    assert!(names.contains(&"dbx_duplicate_connection"));
    assert!(names.contains(&"dbx_execute_redis_command"));
    assert!(names.contains(&"dbx_salesforce_current_user"));
    assert!(names.contains(&"dbx_salesforce_prepare_write"));
    assert!(names.contains(&"dbx_salesforce_apply_write"));
    assert!(names.contains(&"dbx_execute_and_show"));
    assert!(names.contains(&"dbx_execute_batch"));
    assert!(names.contains(&"dbx_list_routines"));
    assert!(names.contains(&"dbx_get_routine_source"));
    assert!(names.contains(&"dbx_open_session"));
    assert!(names.contains(&"dbx_begin_transaction"));
    assert!(names.contains(&"dbx_commit_transaction"));
    assert!(names.contains(&"dbx_rollback_transaction"));
    assert!(names.contains(&"dbx_close_session"));
    #[cfg(feature = "mq-admin")]
    assert!(names.contains(&"dbx_send_message"));

    let server_info = client.peer_info().expect("server info");
    assert!(server_info.capabilities.resources.is_some());

    let resources = client.peer().list_resources(None).await.expect("list resources");
    assert_eq!(resources.resources.len(), 1);
    assert_eq!(resources.resources[0].uri, "dbx://connections");

    let templates = client.peer().list_resource_templates(None).await.expect("list resource templates");
    let template_names = templates.resource_templates.iter().map(|template| template.name.as_str()).collect::<Vec<_>>();
    assert_eq!(template_names, vec!["dbx_connection_databases", "dbx_connection_tables", "dbx_table_schema"]);

    let resource = client
        .peer()
        .read_resource(ReadResourceRequestParams::new("dbx://connections"))
        .await
        .expect("read connections resource");
    let ResourceContents::TextResourceContents { text, mime_type, .. } = &resource.contents[0] else {
        panic!("connections resource should be text");
    };
    assert_eq!(mime_type.as_deref(), Some("text/markdown"));
    assert!(text.contains("catalog-"), "{text}");

    let result = client.peer().call_tool(CallToolRequestParams::new("dbx_list_connections")).await.expect("call tool");
    let response = result.content[0].as_text().expect("text response");
    assert!(response.text.contains("catalog-"), "{}", response.text);

    client.cancel().await.expect("close MCP client");
    server_task.abort();
}

#[tokio::test]
async fn salesforce_write_tools_require_explicit_connection_opt_in() {
    let connection = catalog_connections()
        .into_iter()
        .find(|connection| connection.db_type == DatabaseType::Salesforce)
        .expect("Salesforce catalog connection");
    let connection_id = connection.id.clone();
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(
        Arc::new(PolicyBackend {
            policy: McpGlobalPolicy { allow_dangerous_sql: true, ..Default::default() },
            connections: vec![connection],
            group_paths: Ok(HashMap::new()),
        }),
        McpScope::default(),
        false,
    );
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");

    let tools = client.peer().list_tools(None).await.expect("list tools");
    let names = tools.tools.iter().map(|tool| tool.name.as_ref()).collect::<Vec<_>>();
    assert!(names.contains(&"dbx_salesforce_current_user"));
    assert!(names.contains(&"dbx_execute_query"));
    assert!(!names.contains(&"dbx_salesforce_prepare_write"));
    assert!(!names.contains(&"dbx_salesforce_apply_write"));

    // Hiding tools is not sufficient: a client that already knows the name
    // must still be denied when it sends a valid write request directly.
    let result = client
        .peer()
        .call_tool(CallToolRequestParams::new("dbx_salesforce_prepare_write").with_arguments(
            json!({"connection_id": connection_id, "op": "insert", "object": "Account", "fields": {"Name": "Acme"}})
                .as_object()
                .unwrap()
                .clone(),
        ))
        .await
        .expect("receive denied write result");
    assert_eq!(result.is_error, Some(true));
    let response = result.content[0].as_text().expect("text response");
    assert!(response.text.contains("SALESFORCE_DML_DISABLED"), "{}", response.text);

    client.cancel().await.expect("close MCP client");
    server_task.abort();
}

#[tokio::test]
async fn reads_database_metadata_through_resource_templates() {
    let backend = PolicyBackend {
        policy: McpGlobalPolicy::default(),
        connections: vec![test_connection("local", "local-db")],
        group_paths: Ok(HashMap::new()),
    };
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(Arc::new(backend), McpScope::default(), false);
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");

    for (uri, expected) in [
        ("dbx://connections/local/databases", "analytics"),
        ("dbx://connections/local/tables?database=analytics", "orders (TABLE)"),
        ("dbx://connections/local/table-schema?database=analytics&table=orders", "id (PK)"),
    ] {
        let result = client
            .peer()
            .read_resource(ReadResourceRequestParams::new(uri))
            .await
            .unwrap_or_else(|error| panic!("read {uri}: {error}"));
        let ResourceContents::TextResourceContents { text, mime_type, .. } = &result.contents[0] else {
            panic!("{uri} should return text");
        };
        assert_eq!(mime_type.as_deref(), Some("text/markdown"));
        assert!(text.contains(expected), "{uri}: {text}");
    }

    let invalid = client
        .peer()
        .read_resource(ReadResourceRequestParams::new("dbx://connections/local/table-schema?database=analytics"))
        .await;
    assert!(invalid.is_err());

    client.cancel().await.expect("close MCP client");
    server_task.abort();
}

#[tokio::test]
async fn resource_catalog_follows_the_tool_allowlist() {
    let backend = PolicyBackend {
        policy: McpGlobalPolicy {
            allowed_tool_names: Some(vec!["dbx_list_connections".to_string()]),
            ..Default::default()
        },
        connections: vec![test_connection("local", "local-db")],
        group_paths: Ok(HashMap::new()),
    };
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(Arc::new(backend), McpScope::default(), false);
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");

    let resources = client.peer().list_resources(None).await.expect("list resources");
    assert_eq!(resources.resources.len(), 1);
    let templates = client.peer().list_resource_templates(None).await.expect("list resource templates");
    assert!(templates.resource_templates.is_empty());

    let denied = client
        .peer()
        .read_resource(ReadResourceRequestParams::new("dbx://connections/local/databases"))
        .await
        .expect_err("database resource should respect the tool allowlist");
    assert!(denied.to_string().contains("TOOL_OUT_OF_SCOPE"), "{denied}");

    client.cancel().await.expect("close MCP client");
    server_task.abort();
}

#[cfg(feature = "mq-admin")]
#[tokio::test]
async fn kafka_peek_round_trips_over_mcp_in_local_and_web_modes() {
    let mut connection = test_connection("kafka", "Kafka");
    connection.db_type = dbx_core::models::connection::DatabaseType::MessageQueue;
    connection.read_only = true;
    connection.is_production = true;
    connection.external_config = Some(json!({"systemKind":"kafka", "adminUrl":"", "auth":{"kind":"none"}}));
    for web_mode in [false, true] {
        let backend = Arc::new(CapturingBackend {
            policy: McpGlobalPolicy::default(),
            connections: vec![connection.clone()],
            calls: Mutex::new(vec![]),
        });
        let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
        let server = DbxMcpServer::with_runtime_options(backend.clone(), McpScope::default(), web_mode);
        let server_task = tokio::spawn(async move { server.serve(server_transport).await });
        let client = ().serve(client_transport).await.unwrap();
        let result = client.peer().call_tool(CallToolRequestParams::new("dbx_peek_messages").with_arguments(json!({"connection_name":"Kafka", "topic":"events", "count":100, "start_position":"offset", "partition":0, "offset":120}).as_object().unwrap().clone())).await.unwrap();
        assert_ne!(result.is_error, Some(true), "{result:?}");
        let body: Value = serde_json::from_str(&result.content[0].as_text().unwrap().text).unwrap();
        assert_eq!(body["messages"][0]["payloadText"], "hi");
        assert_eq!(body["incomplete"], false);
        assert_eq!(
            backend.calls.lock().unwrap()[0],
            json!({"connection":"kafka", "topic":"events", "count":100, "options":{"startPosition":"offset", "partition":0, "offset":120}})
        );
        let invalid = client
            .peer()
            .call_tool(
                CallToolRequestParams::new("dbx_peek_messages").with_arguments(
                    json!({"connection_id":"kafka", "topic":"events", "start_position":"invalid"})
                        .as_object()
                        .unwrap()
                        .clone(),
                ),
            )
            .await;
        assert!(invalid.is_err() || invalid.unwrap().is_error == Some(true));
        assert_eq!(backend.calls.lock().unwrap().len(), 1);
        client.cancel().await.unwrap();
        server_task.abort();
    }
}

#[tokio::test]
async fn remove_connection_respects_global_connection_scope() {
    let backend = PolicyBackend {
        policy: McpGlobalPolicy {
            read_only: false,
            allow_dangerous_sql: false,
            allowed_connection_ids: Some(vec!["allowed".to_string()]),
            ..Default::default()
        },
        connections: vec![test_connection("allowed", "allowed-db"), test_connection("blocked", "blocked-db")],
        group_paths: Ok(HashMap::new()),
    };
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(Arc::new(backend), McpScope::default(), false);
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");

    let result = client
        .peer()
        .call_tool(
            CallToolRequestParams::new("dbx_remove_connection")
                .with_arguments(json!({ "connection_id": "blocked" }).as_object().cloned().unwrap_or_else(Map::new)),
        )
        .await
        .expect("call blocked connection removal");
    assert_eq!(result.is_error, Some(true));
    assert!(result.content[0].as_text().expect("blocked removal result").text.contains("CONNECTION_OUT_OF_SCOPE"));

    client.cancel().await.expect("close MCP client");
    server_task.abort();
}

#[tokio::test]
async fn enforces_global_connection_scope_and_read_only_policy() {
    let mut allowed = test_connection("allowed", "shared-db");
    allowed.note = "Allowed connection note".to_string();
    let mut blocked_connection = test_connection("blocked", "blocked-db");
    blocked_connection.note = "Hidden connection note".to_string();
    let backend = PolicyBackend {
        policy: McpGlobalPolicy {
            read_only: true,
            allow_dangerous_sql: false,
            allowed_connection_ids: Some(vec!["allowed".to_string(), "allowed-staging".to_string()]),
            ..Default::default()
        },
        connections: vec![allowed, test_connection("allowed-staging", "shared-db"), blocked_connection],
        group_paths: Ok(HashMap::from([
            ("allowed".to_string(), vec!["Project".to_string(), "Production".to_string()]),
            ("allowed-staging".to_string(), vec!["Project".to_string(), "Staging".to_string()]),
            ("blocked".to_string(), vec!["Secret".to_string()]),
        ])),
    };
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(Arc::new(backend), McpScope::default(), false);
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");

    let listed =
        client.peer().call_tool(CallToolRequestParams::new("dbx_list_connections")).await.expect("list connections");
    let listed_text = listed.content[0].as_text().expect("list result").text.clone();
    assert_eq!(listed_text.matches("shared-db").count(), 2);
    assert!(!listed_text.contains("blocked-db"));
    assert!(listed_text.contains("Project / Production"));
    assert!(listed_text.contains("Project / Staging"));
    assert!(!listed_text.contains("Secret"));
    assert!(listed_text.contains("Allowed connection note"));
    assert!(!listed_text.contains("Hidden connection note"));

    let resource = client
        .peer()
        .read_resource(ReadResourceRequestParams::new("dbx://connections"))
        .await
        .expect("read scoped connections resource");
    let ResourceContents::TextResourceContents { text, .. } = &resource.contents[0] else {
        panic!("connections resource should be text");
    };
    assert_eq!(text, &listed_text);

    let blocked = client
        .peer()
        .call_tool(CallToolRequestParams::new("dbx_execute_query").with_arguments(
            json!({ "connection_id": "blocked", "sql": "SELECT 1" }).as_object().cloned().unwrap_or_else(Map::new),
        ))
        .await
        .expect("call blocked connection");
    assert_eq!(blocked.is_error, Some(true));
    assert!(blocked.content[0].as_text().expect("blocked result").text.contains("CONNECTION_OUT_OF_SCOPE"));

    let read_only = client
        .peer()
        .call_tool(
            CallToolRequestParams::new("dbx_execute_query").with_arguments(
                json!({ "connection_id": "allowed", "sql": "DELETE FROM users" })
                    .as_object()
                    .cloned()
                    .unwrap_or_else(Map::new),
            ),
        )
        .await
        .expect("call read-only policy");
    assert_eq!(read_only.is_error, Some(true));
    assert!(read_only.content[0].as_text().expect("read-only result").text.contains("MCP_READ_ONLY"));

    client.cancel().await.expect("close MCP client");
    server_task.abort();
}

/// Regression for issue #6053: MCP read-only mode let some write-capable SQL
/// through because the read-only gate consulted only the keyword heuristic and
/// ignored the SQL risk classifier it had already computed.
#[tokio::test]
async fn read_only_policy_blocks_write_capable_sql_the_keyword_scan_misses() {
    for (allow_dangerous_sql, sql) in [
        // MySQL's legacy spelling of FOR SHARE — takes the same shared row
        // locks and is reachable with the plain read-only execution mode.
        (false, "SELECT * FROM users LOCK IN SHARE MODE"),
        (true, "SELECT * FROM users LOCK IN SHARE MODE"),
        (true, "SELECT * FROM users FOR SHARE"),
    ] {
        let backend = PolicyBackend {
            policy: McpGlobalPolicy {
                read_only: true,
                allow_dangerous_sql,
                allowed_connection_ids: None,
                ..Default::default()
            },
            connections: vec![mysql_connection("mysql", "reporting")],
            group_paths: Ok(HashMap::new()),
        };
        let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
        let server = DbxMcpServer::with_runtime_options(Arc::new(backend), McpScope::default(), false);
        let server_task = tokio::spawn(async move { server.serve(server_transport).await });
        let client = ().serve(client_transport).await.expect("initialize MCP client");

        let result = client
            .peer()
            .call_tool(CallToolRequestParams::new("dbx_execute_query").with_arguments(
                json!({ "connection_id": "mysql", "sql": sql }).as_object().cloned().unwrap_or_else(Map::new),
            ))
            .await
            .expect("call read-only policy");
        let text = result.content[0].as_text().expect("tool result text").text.clone();
        assert_eq!(
            result.is_error,
            Some(true),
            "{sql} (allow_dangerous_sql={allow_dangerous_sql}) reached the backend"
        );
        assert!(
            text.contains("MCP_READ_ONLY"),
            "expected MCP_READ_ONLY for {sql} (allow_dangerous_sql={allow_dangerous_sql}), got: {text}"
        );

        client.cancel().await.expect("close MCP client");
        server_task.abort();
    }
}

#[tokio::test]
async fn read_only_policy_allows_read_only_show_statements() {
    for (connection, sql) in [
        (mysql_connection("mysql", "reporting"), "SHOW COLLATION"),
        (postgres_connection("postgres", "reporting"), "SHOW search_path"),
    ] {
        let connection_id = connection.id.clone();
        let backend = PolicyBackend {
            policy: McpGlobalPolicy {
                read_only: true,
                allow_dangerous_sql: false,
                allowed_connection_ids: None,
                ..Default::default()
            },
            connections: vec![connection],
            group_paths: Ok(HashMap::new()),
        };
        let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
        let server = DbxMcpServer::with_runtime_options(Arc::new(backend), McpScope::default(), false);
        let server_task = tokio::spawn(async move { server.serve(server_transport).await });
        let client = ().serve(client_transport).await.expect("initialize MCP client");

        let result = client
            .peer()
            .call_tool(CallToolRequestParams::new("dbx_execute_query").with_arguments(
                json!({ "connection_id": connection_id, "sql": sql }).as_object().cloned().unwrap_or_else(Map::new),
            ))
            .await
            .expect("call read-only policy");
        let text = result.content[0].as_text().expect("tool result text").text.clone();
        assert!(!text.contains("MCP_READ_ONLY"), "read-only SHOW was blocked: {sql}: {text}");
        assert!(text.contains("query should have been blocked"), "expected {sql} to reach the backend, got: {text}");

        client.cancel().await.expect("close MCP client");
        server_task.abort();
    }
}

#[tokio::test]
async fn duplicate_connection_rejects_ambiguous_source_names() {
    let backend = PolicyBackend {
        policy: McpGlobalPolicy::default(),
        connections: vec![test_connection("first", "shared"), test_connection("second", "shared")],
        group_paths: Ok(HashMap::new()),
    };
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(Arc::new(backend), McpScope::default(), false);
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");
    let result = client
        .peer()
        .call_tool(CallToolRequestParams::new("dbx_duplicate_connection").with_arguments(
            json!({ "connection_name": "shared", "new_name": "copy" }).as_object().cloned().unwrap_or_else(Map::new),
        ))
        .await
        .expect("call duplicate connection");
    assert_eq!(result.is_error, Some(true));
    assert!(result.content[0].as_text().expect("ambiguous result").text.contains("AMBIGUOUS_CONNECTION"));
    client.cancel().await.expect("close MCP client");
    server_task.abort();
}

#[tokio::test]
async fn connection_group_path_failure_preserves_connection_listing() {
    let backend = PolicyBackend {
        policy: McpGlobalPolicy::default(),
        connections: vec![test_connection("local", "local-db")],
        group_paths: Err("layout unavailable".to_string()),
    };
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(Arc::new(backend), McpScope::default(), false);
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");

    let listed =
        client.peer().call_tool(CallToolRequestParams::new("dbx_list_connections")).await.expect("list connections");
    let listed_text = listed.content[0].as_text().expect("list result").text.clone();
    assert_ne!(listed.is_error, Some(true));
    assert!(listed_text.contains("| ID | Name | Group Path |"));
    assert!(listed_text.contains("local-db"));
    assert!(listed_text.contains("| Database | Note |"));
    assert!(listed_text.contains("| :memory: |  |"));

    client.cancel().await.expect("close MCP client");
    server_task.abort();
}

#[tokio::test]
async fn runtime_connection_scope_preserves_group_paths() {
    let mut scoped = test_connection("scoped", "shared-db");
    scoped.note = "业务库 | TEST\n只读查询".to_string();
    let mut outside = test_connection("outside", "shared-db");
    outside.note = "Out-of-scope connection note".to_string();
    let backend = PolicyBackend {
        policy: McpGlobalPolicy::default(),
        connections: vec![scoped, outside],
        group_paths: Ok(HashMap::from([
            ("scoped".to_string(), vec!["Project".to_string(), "Production".to_string()]),
            ("outside".to_string(), vec!["Project".to_string(), "Staging".to_string()]),
        ])),
    };
    let (server_transport, client_transport) = tokio::io::duplex(16 * 1024);
    let server = DbxMcpServer::with_runtime_options(
        Arc::new(backend),
        McpScope { connection_ids: vec!["scoped".to_string()], ..Default::default() },
        false,
    );
    let server_task = tokio::spawn(async move { server.serve(server_transport).await });
    let client = ().serve(client_transport).await.expect("initialize MCP client");

    let listed =
        client.peer().call_tool(CallToolRequestParams::new("dbx_list_connections")).await.expect("list connections");
    let listed_text = listed.content[0].as_text().expect("list result").text.clone();
    assert!(listed_text.contains("| scoped | shared-db | Project / Production |"));
    assert!(!listed_text.contains("outside"));
    assert!(!listed_text.contains("Project / Staging"));
    assert!(listed_text.contains("业务库 \\| TEST 只读查询"));
    assert!(!listed_text.contains("Out-of-scope connection note"));
    assert_eq!(listed_text.lines().count(), 3);

    let resource = client
        .peer()
        .read_resource(ReadResourceRequestParams::new("dbx://connections"))
        .await
        .expect("read scoped connections resource");
    let ResourceContents::TextResourceContents { text, .. } = &resource.contents[0] else {
        panic!("connections resource should be text");
    };
    assert_eq!(text, &listed_text);

    client.cancel().await.expect("close MCP client");
    server_task.abort();
}