database-query - SKILL.md Agent Skill

name: database-query description: 通过 Evotown Database MCP Proxy 对已注册的业务数据库执行只读 SQL 查询。当用户需要查 CRM、订单、报表等结构化数据时使用；禁止直连数据库或写入 SQL。 license: MIT compatibility: Python 3.x，需网络访问 EVOTOWN_DB_MCP_URL（默认 http://localhost:9100） metadata: author: evotown version: "1.0"

Database Query Skill

通过 Evotown Database MCP Proxy 查询企业已注册数据库。Skill 不持有连接串；权限由 Evotown ACL + Proxy 校验。

前置条件

管理员在 Evotown 控制台注册数据库并配置 MCP 地址
当前员工 API Key 已被授权访问目标 connection_id
MCP Proxy 服务已启动（EVOTOWN_DB_MCP_URL，默认 http://localhost:9100）

动作

action	说明
`list_connections`	列出当前员工可访问的数据库
`list_tables`	列出某库的表
`query`	执行只读 SELECT（Proxy 自动加 LIMIT，拒绝 INSERT/UPDATE/DELETE）

示例

列出可访问数据库

{
  "action": "list_connections",
  "api_key": "evk_..."
}

查表

{
  "action": "list_tables",
  "connection_id": "crm-demo",
  "api_key": "evk_..."
}

只读查询

{
  "action": "query",
  "connection_id": "crm-demo",
  "sql": "SELECT id, name, amount FROM orders WHERE status = 'paid'",
  "api_key": "evk_..."
}

也可设置环境变量 EVOTOWN_EMPLOYEE_API_KEY，省略 api_key 字段。

Runtime

entry_point: scripts/main.py
language: python
network:
  enabled: true
  outbound:
    - "*:9100"
    - "*:8765"
input_schema:
  type: object
  properties:
    action:
      type: string
      enum: [list_connections, list_tables, query]
      default: query
    connection_id:
      type: string
      description: Evotown 注册的 connection_id
    sql:
      type: string
      description: 只读 SELECT / WITH / EXPLAIN 语句
    api_key:
      type: string
      description: 员工 evk_ API Key（可改用环境变量 EVOTOWN_EMPLOYEE_API_KEY）
  required: []