前言¶
在 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 许可证。
