---
name: 🐛 Bug Report
about: Create a report to help us improve
title: 'bug: '
labels: ['bug', 'needs-triage']
assignees: ''
---
# 🐛 Bug Report
## 📝 Description
<!-- A clear and concise description of what the bug is -->
## 🔄 Steps to Reproduce
1. Go to '...'
2. Click on '...'
3. Scroll down to '...'
4. See error
## ✅ Expected Behavior
<!-- A clear and concise description of what you expected to happen -->
## ❌ Actual Behavior
<!-- A clear and concise description of what actually happened -->
## 📱 Environment
<!-- Please complete the following information -->
- **OS**: [e.g., Ubuntu 22.04, macOS 13.0, Windows 11]
- **Node.js Version**: [e.g., 18.17.0, 20.5.0, 22.0.0]
- **Package Version**: [e.g., 0.6.0]
- **MCP Client**: [e.g., Claude Code, custom client]
- **Installation Method**: [e.g., npm install, git clone]
## 🖼 Screenshots/Logs
<!-- If applicable, add screenshots or log output to help explain your problem -->
### Error Logs
```
Paste relevant error logs here
```
### MCP Communication Logs
```
Paste MCP protocol logs if available
```
## 🧪 Minimal Reproduction
<!-- Please provide the smallest possible reproduction case -->
### Code Example
```typescript
// Minimal code that reproduces the issue
```
### Configuration
```json
{
"relevant": "configuration here"
}
```
## 🔍 Additional Context
<!-- Add any other context about the problem here -->
### Frequency
- [ ] Happens every time
- [ ] Happens sometimes
- [ ] Happened once
### Impact
- [ ] Blocks all functionality
- [ ] Blocks some functionality
- [ ] Cosmetic issue
- [ ] Performance issue
### Workaround
<!-- Is there a temporary workaround? -->
- [ ] No workaround found
- [ ] Workaround available (please describe below)
### Workaround Description
<!-- If you found a workaround, please describe it -->
## 🔧 Possible Solution
<!-- If you have ideas on how to fix this bug, please describe them -->
## 📋 Checklist
<!-- Please check all that apply -->
- [ ] I have searched existing issues to make sure this is not a duplicate
- [ ] I have provided all requested information
- [ ] I have tested with the latest version
- [ ] I have provided a minimal reproduction case
- [ ] I have included relevant logs/screenshots
## 🏷 Labels
<!-- The maintainers will add appropriate labels, but you can suggest them -->
Suggested labels: bug, needs-triage
<!-- If this is a security issue, please email instead of creating a public issue -->
