---
name: Bug Report
about: Report a bug or unexpected behavior
title: '[BUG] '
labels: bug
assignees: ''
---
## Bug Description
A clear and concise description of what the bug is.
## Steps to Reproduce
1. Configure server with '...'
2. Execute query '....'
3. See error
## Expected Behavior
A clear description of what you expected to happen.
## Actual Behavior
What actually happened instead.
## Environment
- **Runtime**: Bun / Node.js (specify version)
- **MCP Client**: Claude Code / Codex CLI / Other
- **MySQL Version**:
- **Operating System**:
- **Project Version**:
## Configuration
```env
# Relevant parts of your .env (DO NOT include passwords!)
MYSQL_HOST=localhost
MYSQL_PORT=3306
ALLOW_INSERT_OPERATION=false
# etc...
```
## Error Messages
```
Paste any error messages, logs, or stack traces here
```
## Server Logs
```
Paste relevant server logs (stderr output) here
```
## Additional Context
Add any other context about the problem here. Screenshots, query examples, etc.
## Possible Solution
If you have ideas on how to fix this, please share!
## Checklist
- [ ] I have checked existing issues for duplicates
- [ ] I have included all relevant error messages
- [ ] I have provided my environment details
- [ ] I have removed any sensitive information (passwords, etc.)
