mcpField
S
smart-query

smart-query

github.com/zrt-ai-labデータ・データベース29669 回インストール14 週間前に更新
リポジトリ

smart-query について

Smart Queryは、本番データベースを調べるユーザー向けのスキルです。SSHトンネル経由の接続とSQL実行に対応し、自然言語での検索手順やスキーマ文書の生成も行えます。

主な機能

  1. 01SSHトンネル経由のデータベース接続
  2. 02SQLクエリの実行
  3. 03テーブル形式とJSON形式での出力
  4. 04スキーマ文書の生成
  5. 05自然言語による検索フロー

活用シーン

  1. 01本番データベースのレコードを検索する
  2. 02テーブルやカラムの構造を確認する
  3. 03検索結果をJSON形式で出力する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zrt-ai-lab/opencode-skills --skill smart-query

インストール後、Claude Code で/smart-queryを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
assets/
.gitkeep
config/
settings.json
settings.json.example
references/
schema.md
scripts/
db_connector.py
query.py
schema_loader.py

詳細

プロジェクトの README より

Smart Query - 智能问数

通过 SSH 隧道安全连接线上数据库，支持自然语言查询和 SQL 执行。

触发场景

  • 用户问"查一下xxx数据"、"帮我看看xxx表"
  • 用户需要查询线上数据库
  • 用户问"有哪些表"、"表结构是什么"

快速使用

1. 测试连接
python .opencode/skills/smart-query/scripts/db_connector.py
2. 执行SQL查询
python .opencode/skills/smart-query/scripts/query.py "SELECT * FROM table_name LIMIT 10"
python .opencode/skills/smart-query/scripts/query.py "SHOW TABLES"
python .opencode/skills/smart-query/scripts/query.py "DESC table_name"

参数：

  • -n 50：限制返回行数
  • -f json：JSON格式输出
  • --raw：输出原始结果（含元信息）
3. 生成表结构文档
python .opencode/skills/smart-query/scripts/schema_loader.py

生成 references/schema.md，包含所有表结构信息。

自然语言查询流程

  1. 理解用户意图：分析用户想查什么数据
  2. 查阅表结构：读取 references/schema.md 了解表结构
  3. 生成SQL：根据表结构编写正确的SQL
  4. 执行查询：使用 query.py 执行
  5. 解读结果：用通俗语言解释查询结果

配置说明

配置文件：config/settings.json

{
  "ssh": {
    "host": "SSH跳板机地址",
    "port": 22,
    "username": "用户名",
    "password": "密码",
    "key_file": null
  },
  "database": {
    "type": "mysql",
    "host": "数据库内网地址",
    "port": 3306,
    "database": "库名",
    "username": "数据库用户",
    "password": "数据库密码"
  }
}

分享给同事

  1. 复制整个 smart-query/ 目录
  2. 同事复制 config/settings.json.example 为 settings.json
  3. 填入自己的 SSH 和数据库连接信息
  4. 安装依赖：pip install paramiko sshtunnel pymysql

安全提示

  • config/settings.json 包含敏感信息，不要提交到 Git
  • 建议将 config/settings.json 加入 .gitignore
  • 只执行 SELECT 查询，避免 UPDATE/DELETE 操作

依赖安装

pip install paramiko sshtunnel pymysql

脚本清单

脚本用途
scripts/db_connector.pySSH隧道+数据库连接，可单独运行测试连接
scripts/query.py执行SQL查询，支持表格/JSON输出
scripts/schema_loader.py加载表结构，生成 schema.md

参考文档

文档说明
references/schema.md数据库表结构（运行 schema_loader.py 生成）

コメント

Markdown 対応