前言¶
在 DeepSeek Harness (DSH) 的生態中，讓大模型直接與數據庫交互需要解決安全性和可控性問題。xby-db 插件提供了一種通過 MCP 協議安全訪問數據庫的方案。它作爲一個 MCP Database Server，旨在爲 AI 助手和基於 LLM 的工具提供標準化的數據庫訪問接口。
核心功能¶
該插件提供以下主要能力：
- set_xby_apikey：在聊天上下文中設置 API 密鑰。該密鑰會自動持久化，並在重啓後保持有效。
- db_tables：列出數據庫中的所有表。支持按 schema 過濾，並返回限定表名。
- db_describe_table：獲取特定表的列信息，包括列名、數據類型和可空性。
- db_execute：執行 SQL 語句。支持 SELECT（讀操作）、INSERT/UPDATE/DELETE（寫操作，需在配置中啓用）以及 DDL（需在配置中啓用）。支持使用
:param語法的命名參數。 - db_explain：使用 EXPLAIN 獲取查詢執行計劃及性能信息，用於分析查詢效率和優化空間。
安裝¶
通過以下命令安裝插件：
dsh plugin --profile web add github:xby_skill/xby-db
配置與權限¶
在使用前，需要完成以下配置：
- 獲取密鑰：前往 小笨羊官網 註冊並獲取 API 密鑰。
- 啓用寫操作：如需執行 INSERT、UPDATE、DELETE 或 DDL 語句，必須在 DSH 的配置中啓用相應權限。
- 數據庫支持：插件支持 SQLite、PostgreSQL、MySQL 和 MariaDB。
安全與生態¶
插件內置了查詢驗證、審計日誌和安全控制功能，確保數據庫操作的安全性。作爲 DSH 生態的一部分，它遵循“一切皆插件”的理念。安裝前建議檢查源碼與 MIT 許可證。
