Skip to content

Resources

Temp edited this page Feb 25, 2026 · 4 revisions

Resources

Resources provide real-time database information through URI patterns. Unlike tools which perform actions, resources expose read-only observability data.


Available Resources (18 total)

Core Resources

Resource Description
mysql://schema Full database schema including tables, views, and indexes
mysql://tables Table listing with metadata (row counts, sizes, engines)
mysql://variables Server configuration variables (SHOW GLOBAL VARIABLES)
mysql://status Server status metrics (SHOW GLOBAL STATUS)
mysql://processlist Active connections and currently running queries
mysql://pool Connection pool statistics (total, active, idle, waiting)

Monitoring Resources

Resource Description
mysql://capabilities Server version, supported features, and tool categories
mysql://health Comprehensive health status (connections, performance, InnoDB)
mysql://performance Query performance metrics and top queries by time
mysql://indexes Index usage statistics, unused indexes, duplicate detection
mysql://replication Replication status, lag, GTID info, connected replicas
mysql://innodb InnoDB buffer pool stats, row operations, I/O metrics
mysql://events Event Scheduler status and scheduled events
mysql://sysschema sys schema diagnostics summary
mysql://locks InnoDB lock contention detection
mysql://cluster Group Replication/InnoDB Cluster status
mysql://spatial Spatial columns and indexes
mysql://docstore Document Store collections

Using Resources

Resources are accessed by MCP clients automatically. In Claude Desktop or Cursor, you can reference them directly:

Show me the database health status
→ Uses mysql://health resource

What tables exist in this database?
→ Uses mysql://tables resource

Check the replication lag
→ Uses mysql://replication resource

Show me any locking issues
→ Uses mysql://locks resource

Resource Details

mysql://capabilities

Shows server information and MCP server capabilities:

  • MySQL version and supported features
  • JSON support, FULLTEXT, partitioning availability
  • All tool groups and meta-groups with tool counts

mysql://health

Comprehensive health dashboard:

  • Connection pool utilization and thread activity
  • Buffer pool hit ratio and memory usage
  • Slow query count
  • Query mix (SELECT/INSERT/UPDATE/DELETE counts)

mysql://performance

Query performance insights:

  • Total queries and slow query count
  • Temporary tables to disk ratio
  • Full table scan percentage
  • Top 10 queries by execution time (if performance_schema enabled)
  • Handler statistics (index reads vs table scans)

mysql://indexes

Index analysis:

  • All indexes with cardinality and type
  • Unused indexes (never scanned)
  • Potential duplicate/redundant indexes

mysql://replication

Replication monitoring:

  • Server role (source, replica, standalone)
  • Binary log position
  • Replica I/O and SQL thread status
  • Seconds behind source (replication lag)
  • GTID configuration

mysql://innodb

InnoDB engine metrics:

  • Buffer pool size and hit ratio
  • Page statistics (total, free, dirty)
  • Row operations (reads, inserts, updates, deletes)
  • I/O statistics

mysql://cluster

Group Replication & InnoDB Cluster status:

  • Member state (ONLINE, RECOVERING)
  • Primary/Secondary check
  • Cluster topology

mysql://sysschema

High-level performance summary from sys schema:

  • Top I/O users
  • Worst performing statements
  • Host summary

mysql://locks

Lock contention analysis:

  • Currently blocked transactions
  • Blocking transaction ID and query
  • Wait duration

See Also

Clone this wiki locally