This server has critical definition quality gaps. All three tools lack proper English descriptions (descriptions are in Chinese and very brief), parameters lack type safety and detailed constraints, and no output schemas are documented. The tools are READ_ONLY but lack explicit idempotent hints. The server uses environment variable secrets correctly, but tool definitions themselves are minimal and would confuse LLMs operating in English.

• Translate all tool descriptions to English and expand to 100-200 characters. Include WHEN to use (e.g. 'Use this to execute ad-hoc SQL queries on any Superset datasource without manually navigating the UI'), prerequisites (valid Superset API URL and auth), and a summary of return type (e.g. 'Returns query result rows as JSON or error details').
• Document output schemas for all three tools. Example for list-databases: '{"databases": [{"id": number, "database_name": string, "engine": string, "sqlalchemy_uri": string}], "total": number}'
• Add explicit parameter descriptions for optional fields. For query-superset: 'If databaseId is omitted, the tool attempts to match the table name in the query text against all available tables. If schema and tableName are provided, they override automatic matching.'
• Replace example values in descriptions with format constraints. Instead of 'e.g. query latest 10 logs', describe: 'A natural language phrase describing the data you want (e.g. database name, table name, and any filtering keywords). English only.'
• Add pagination to list-databases and list-tables. Accept optional 'limit' (1-500, default 50) and 'offset' (default 0) parameters; return 'total_count' and 'has_more' flags in responses.
• Add error handling guidance to descriptions. Example for query-superset: 'On timeout, try adding a LIMIT clause or filtering by date. If table not found, call list-tables first to verify table name and schema.'
• Add readOnlyHint: true to all three tool definitions (src/index.ts server.tool() registrations) to explicitly signal idempotence and read-only semantics.