{"_id":"8-bits-music-mcp","_rev":"7-744f1e48d7ad82fdee09d9c5a425664d","name":"8-bits-music-mcp","dist-tags":{"latest":"1.0.6"},"versions":{"1.0.0":{"name":"8-bits-music-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","8-bit","music","chiptune","tone.js","audio","midi","wav","retro","game-music","claude","ai-tools"],"author":{"name":"Daniel Díaz","email":"tu-email@example.com"},"license":"MIT","_id":"8-bits-music-mcp@1.0.0","maintainers":[{"name":"zwitterkaneda","email":"smentek@gmail.com"}],"homepage":"https://github.com/ZwitterKaneda/8-bits-music-mcp#readme","bugs":{"url":"https://github.com/ZwitterKaneda/8-bits-music-mcp/issues"},"dist":{"shasum":"2c73f5f84df0371492dc0b43b8df1990250a4027","tarball":"https://registry.npmjs.org/8-bits-music-mcp/-/8-bits-music-mcp-1.0.0.tgz","fileCount":75,"integrity":"sha512-YXHA+Tg984GS9pi4K+8b+bCIcYu6tiHnRLTUZ8BNszTzrNYO5HwkJPvSrVv+42C12wGghYc9W8hz1kos8xV5kA==","signatures":[{"sig":"MEQCIF4DUAtuQESob1k9qnfni6cu1wil60MZFsjoleZ9N+AkAiBNdbcnG/uk0t6OMXHkFdKqM5hxL4p68s7M4DGZeLZg4Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":135741},"main":"packages/mcp-server/dist/server.js","type":"module","types":"./packages/mcp-server/dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"e92909b0b071974d4a1f8cb4c4777380db46cfcf","scripts":{"dev":"npm run dev --workspaces","test":"npm run test --workspaces","build":"npm run build --workspaces","prepublishOnly":"npm run build"},"_npmUser":{"name":"zwitterkaneda","email":"smentek@gmail.com"},"repository":{"url":"git+https://github.com/ZwitterKaneda/8-bits-music-mcp.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.4.2","description":"A Model Context Protocol server for generating authentic 8-bit music","directories":{},"_nodeVersion":"22.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/8-bits-music-mcp_1.0.0_1760491313746_0.7044292726127177","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"8-bits-music-mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","8-bit","music","chiptune","tone.js","audio","midi","wav","retro","game-music","claude","ai-tools"],"author":{"name":"Daniel Díaz","email":"tu-email@example.com"},"license":"MIT","_id":"8-bits-music-mcp@1.0.1","maintainers":[{"name":"zwitterkaneda","email":"smentek@gmail.com"}],"homepage":"https://github.com/ZwitterKaneda/8-bits-music-mcp#readme","bugs":{"url":"https://github.com/ZwitterKaneda/8-bits-music-mcp/issues"},"dist":{"shasum":"40d89ee657df63289a4336c529faaa1e1d28de69","tarball":"https://registry.npmjs.org/8-bits-music-mcp/-/8-bits-music-mcp-1.0.1.tgz","fileCount":75,"integrity":"sha512-cKwJaqkJqtdXOvdwKQ/HQnKw4EYXoTBpHSUY7C5oQQaAuUl1AHVTS3H/DWQGI+sWnKlAWS61xbUpHAEnfQ2X6g==","signatures":[{"sig":"MEUCIQCZu4svrbn3ttx8p/wtKaI/PBW8b5Z/5+9FWiF1APf2hgIgfrYljmeTHMoLnJQGoaczp6OwN74uRaTLOvKI9cqMOsY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":148864},"main":"packages/mcp-server/dist/server.js","type":"module","types":"./packages/mcp-server/dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"b8b7147dc453645bdf9cf6ba2c4c27efdc084a57","scripts":{"dev":"npm run dev --workspaces","test":"npm run test --workspaces","build":"npm run build --workspaces","prepublishOnly":"npm run build"},"_npmUser":{"name":"zwitterkaneda","email":"smentek@gmail.com"},"repository":{"url":"git+https://github.com/ZwitterKaneda/8-bits-music-mcp.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.4.2","description":"A Model Context Protocol server for generating authentic 8-bit music","directories":{},"_nodeVersion":"22.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/8-bits-music-mcp_1.0.1_1760494207323_0.3897313837622336","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"8-bits-music-mcp","version":"1.0.2","keywords":["mcp","model-context-protocol","8-bit","music","chiptune","tone.js","audio","midi","wav","retro","game-music","claude","ai-tools"],"author":{"name":"Daniel Díaz","email":"tu-email@example.com"},"license":"MIT","_id":"8-bits-music-mcp@1.0.2","maintainers":[{"name":"zwitterkaneda","email":"smentek@gmail.com"}],"homepage":"https://github.com/ZwitterKaneda/8-bits-music-mcp#readme","bugs":{"url":"https://github.com/ZwitterKaneda/8-bits-music-mcp/issues"},"bin":{"8-bits-music-mcp":"packages/mcp-server/dist/server.js"},"dist":{"shasum":"f41dd6c3e5e817ce7cbcd5aa3fef4db2b04fdce3","tarball":"https://registry.npmjs.org/8-bits-music-mcp/-/8-bits-music-mcp-1.0.2.tgz","fileCount":70,"integrity":"sha512-9/gAR3Eb+4Kn1XRLRFb1/N73gLktQi7975Pjjt5l1TdVIUtgGmfpkR9xqZ090GgmuzQf8Z9RRtaxkF4hz8w6ug==","signatures":[{"sig":"MEUCIQDThdovBDaqeY6Gi4t1bSxatZGzYUCdaalsTecSdvzBFgIgaBYnu0pcw06eCFz3j00xLkvQYz64dINMcoOjuFgZbyc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":67192},"main":"packages/mcp-server/dist/server.js","type":"module","types":"./packages/mcp-server/dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"b8b7147dc453645bdf9cf6ba2c4c27efdc084a57","scripts":{"dev":"npm run dev --workspaces","test":"npm run test --workspaces","build":"npm run build --workspaces","prepublishOnly":"npm run build"},"_npmUser":{"name":"zwitterkaneda","email":"smentek@gmail.com"},"repository":{"url":"git+https://github.com/ZwitterKaneda/8-bits-music-mcp.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.4.2","description":"A Model Context Protocol server for generating authentic 8-bit music","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.4","tone":"^15.0.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/8-bits-music-mcp_1.0.2_1760494578404_0.7444362000303668","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"8-bits-music-mcp","version":"1.0.3","keywords":["mcp","model-context-protocol","8-bit","music","chiptune","tone.js","audio","midi","wav","retro","game-music","claude","ai-tools"],"author":{"name":"Daniel Díaz","email":"tu-email@example.com"},"license":"MIT","_id":"8-bits-music-mcp@1.0.3","maintainers":[{"name":"zwitterkaneda","email":"smentek@gmail.com"}],"homepage":"https://github.com/ZwitterKaneda/8-bits-music-mcp#readme","bugs":{"url":"https://github.com/ZwitterKaneda/8-bits-music-mcp/issues"},"bin":{"8-bits-music-mcp":"packages/mcp-server/dist/server.js"},"dist":{"shasum":"a2c34e907063fdb7977a234d2164a545f1bd89f7","tarball":"https://registry.npmjs.org/8-bits-music-mcp/-/8-bits-music-mcp-1.0.3.tgz","fileCount":70,"integrity":"sha512-XMXkR7gdzDuuAxmXUtQ3fGoMiomv7GulCOWEdHGU24qeejIRB6IxSVjHXd7Izns/w5zkMVVUDJQ1xrYXtrRBpQ==","signatures":[{"sig":"MEYCIQCP5Nmu58wrZT0IQ5KeAzGsvXTuGwgL2ERC4K5Mp5JYUgIhAOAMbk82wX4+rK5CNJQO1d5Z15CfZ8ieMDZET79f+ANd","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72296},"main":"packages/mcp-server/dist/server.js","type":"module","types":"./packages/mcp-server/dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"b641d99f4ec2f958b106ecb12c4e3812e6f4b424","scripts":{"dev":"npm run dev --workspaces","test":"npm run test --workspaces","build":"npm run build --workspaces","prepublishOnly":"npm run build"},"_npmUser":{"name":"zwitterkaneda","email":"smentek@gmail.com"},"repository":{"url":"git+https://github.com/ZwitterKaneda/8-bits-music-mcp.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.4.2","description":"A Model Context Protocol server for generating authentic 8-bit music","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.4","tone":"^15.0.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/8-bits-music-mcp_1.0.3_1760494975494_0.3759983723052205","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"8-bits-music-mcp","version":"1.0.4","keywords":["mcp","model-context-protocol","8-bit","music","chiptune","tone.js","audio","midi","wav","retro","game-music","claude","ai-tools"],"author":{"name":"Daniel Díaz","email":"tu-email@example.com"},"license":"MIT","_id":"8-bits-music-mcp@1.0.4","maintainers":[{"name":"zwitterkaneda","email":"smentek@gmail.com"}],"homepage":"https://github.com/ZwitterKaneda/8-bits-music-mcp#readme","bugs":{"url":"https://github.com/ZwitterKaneda/8-bits-music-mcp/issues"},"bin":{"8-bits-music-mcp":"packages/mcp-server/dist/server.js"},"dist":{"shasum":"bee44644eb78881d8f39de12ce3026d253a1a992","tarball":"https://registry.npmjs.org/8-bits-music-mcp/-/8-bits-music-mcp-1.0.4.tgz","fileCount":21,"integrity":"sha512-R+IvfsW4cYbK7bH8CkJyL4zzRhieyVizOiU8DOuSrXfEwy7unG6YaeHbVTZ2UVYX4oTS25HqPwSqv8Phpwm2qg==","signatures":[{"sig":"MEUCIQCaC/HXL3JTeQU80Wz1qGamA3GZpBxguKY+c6ciBZFudAIgDes8aMgansya38UrVIkGmeEVjApnmdmJPiI1rRnQzo8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40442},"main":"packages/mcp-server/dist/server.js","type":"module","types":"./packages/mcp-server/dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"b641d99f4ec2f958b106ecb12c4e3812e6f4b424","scripts":{"dev":"npm run dev --workspaces","test":"npm run test --workspaces","build":"npm run build --workspaces","prepublishOnly":"npm run build"},"_npmUser":{"name":"zwitterkaneda","email":"smentek@gmail.com"},"repository":{"url":"git+https://github.com/ZwitterKaneda/8-bits-music-mcp.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.4.2","description":"A Model Context Protocol server for generating authentic 8-bit music","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.4","tone":"^15.0.0","@modelcontextprotocol/sdk":"^1.0.0","@zwitterkaneda/8bits-music-audio-engine":"^0.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/8-bits-music-mcp_1.0.4_1760495184720_0.9917122141313146","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"8-bits-music-mcp","version":"1.0.5","keywords":["mcp","model-context-protocol","8-bit","music","chiptune","tone.js","audio","midi","wav","retro","game-music","claude","ai-tools"],"author":{"name":"Daniel Díaz","email":"tu-email@example.com"},"license":"MIT","_id":"8-bits-music-mcp@1.0.5","maintainers":[{"name":"zwitterkaneda","email":"smentek@gmail.com"}],"homepage":"https://github.com/ZwitterKaneda/8-bits-music-mcp#readme","bugs":{"url":"https://github.com/ZwitterKaneda/8-bits-music-mcp/issues"},"bin":{"8-bits-music-mcp":"packages/mcp-server/dist/server.js"},"dist":{"shasum":"e4154247c7d91fe8beadbff8e5e7b5724198918f","tarball":"https://registry.npmjs.org/8-bits-music-mcp/-/8-bits-music-mcp-1.0.5.tgz","fileCount":21,"integrity":"sha512-tCZOsvBVIm02YJ6UKcsNPp0tzSow9aCDFPUuxh+MWKS21muZ1AoGGP1NDgY2gx2GwaXBU2VnftKVWQyg9nBX7w==","signatures":[{"sig":"MEUCIDzUQZ0kf8ZL+bGLYxmVzSsc7/6cXgXoEDgwHug6lbXyAiEAuOMVdH7PG+g6z6XbLvZPGzqREQ+nEjEbRIEVuBFiI+c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40442},"main":"packages/mcp-server/dist/server.js","type":"module","types":"./packages/mcp-server/dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"77969aea7c94e3c31bf2ff4ed0eb0cb23d1e857d","scripts":{"dev":"npm run dev --workspaces","test":"npm run test --workspaces","build":"npm run build --workspaces","prepublishOnly":"npm run build"},"_npmUser":{"name":"zwitterkaneda","email":"smentek@gmail.com"},"repository":{"url":"git+https://github.com/ZwitterKaneda/8-bits-music-mcp.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.4.2","description":"A Model Context Protocol server for generating authentic 8-bit music","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.4","tone":"^15.0.0","@modelcontextprotocol/sdk":"^1.0.0","@zwitterkaneda/8bits-music-audio-engine":"^0.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/8-bits-music-mcp_1.0.5_1760495575067_0.11844401871936205","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"8-bits-music-mcp","version":"1.0.6","description":"A Model Context Protocol server for generating authentic 8-bit music","main":"packages/mcp-server/dist/server.js","type":"module","bin":{"8-bits-music-mcp":"packages/mcp-server/dist/server.js"},"keywords":["mcp","model-context-protocol","8-bit","music","chiptune","tone.js","audio","midi","wav","retro","game-music","claude","ai-tools"],"author":{"name":"Daniel Díaz","email":"tu-email@example.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ZwitterKaneda/8-bits-music-mcp.git"},"bugs":{"url":"https://github.com/ZwitterKaneda/8-bits-music-mcp/issues"},"homepage":"https://github.com/ZwitterKaneda/8-bits-music-mcp#readme","engines":{"node":">=18.0.0"},"scripts":{"build":"npm run build --workspaces","dev":"npm run dev --workspaces","test":"npm run test --workspaces","prepublishOnly":"npm run build"},"workspaces":["packages/*"],"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","@zwitterkaneda/8bits-music-audio-engine":"^0.1.0","tone":"^15.0.0","zod":"^3.22.4"},"_id":"8-bits-music-mcp@1.0.6","gitHead":"bae7c4fba7f38607be4cd46c683d1d7ac7ab7af3","types":"./packages/mcp-server/dist/server.d.ts","_nodeVersion":"22.16.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-4hXf0uS31G7V4jD6EsDayw4Gglgvubyu9w+UbNBp56k+AdUKlWmCUDUgDh0vvT9mqSedNJKJsjiq3gMAbtCBNg==","shasum":"0848aa9b8f7c0f22f9aefc08ca069c7e35694478","tarball":"https://registry.npmjs.org/8-bits-music-mcp/-/8-bits-music-mcp-1.0.6.tgz","fileCount":21,"unpackedSize":34695,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCvky6I2UjBsMR+CvYFJ9l85QMvm/JKa8bEyVt01Uzl5gIgeRgwmE4p59Z3MmMmanR/39Ut1IKjoVHpjGqHcOOXx6E="}]},"_npmUser":{"name":"zwitterkaneda","email":"smentek@gmail.com"},"directories":{},"maintainers":[{"name":"zwitterkaneda","email":"smentek@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/8-bits-music-mcp_1.0.6_1760496299237_0.9557610031779329"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-15T01:21:53.745Z","modified":"2025-10-15T02:44:59.625Z","1.0.0":"2025-10-15T01:21:53.987Z","1.0.1":"2025-10-15T02:10:07.548Z","1.0.2":"2025-10-15T02:16:18.631Z","1.0.3":"2025-10-15T02:22:55.703Z","1.0.4":"2025-10-15T02:26:24.924Z","1.0.5":"2025-10-15T02:32:55.278Z","1.0.6":"2025-10-15T02:44:59.423Z"},"bugs":{"url":"https://github.com/ZwitterKaneda/8-bits-music-mcp/issues"},"author":{"name":"Daniel Díaz","email":"tu-email@example.com"},"license":"MIT","homepage":"https://github.com/ZwitterKaneda/8-bits-music-mcp#readme","keywords":["mcp","model-context-protocol","8-bit","music","chiptune","tone.js","audio","midi","wav","retro","game-music","claude","ai-tools"],"repository":{"type":"git","url":"git+https://github.com/ZwitterKaneda/8-bits-music-mcp.git"},"description":"A Model Context Protocol server for generating authentic 8-bit music","maintainers":[{"name":"zwitterkaneda","email":"smentek@gmail.com"}],"readme":"# 🎵 8-Bit Music MCP Server\n\n[![npm version](https://img.shields.io/npm/v/8-bits-music-mcp.svg)](https://www.npmjs.com/package/8-bits-music-mcp)\n[![MCP Protocol](https://img.shields.io/badge/MCP-Protocol-blue.svg)](https://modelcontextprotocol.io/)\n[![Node.js](https://img.shields.io/badge/Node.js-18+-339933.svg)](https://nodejs.org/)\n[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n> Transform your AI assistant into a retro game music composer! This MCP server gives Claude, Cursor, and other AI tools the power to create authentic 8-bit chiptunes with professional audio output.\n\n## 🚀 Quick Start (2 minutes)\n\n### Step 1: Install Node.js\n\nMake sure you have **Node.js 18 or higher** installed:\n```bash\nnode --version\n```\n\nIf you don't have it, download it from [nodejs.org](https://nodejs.org/)\n\n### Step 2: Configure Your AI Assistant\n\nChoose your preferred AI tool and follow the configuration:\n\n#### 🤖 **Claude Desktop** (Most Popular)\n\n1. Open Claude Desktop configuration file:\n   - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n   - **Linux:** `~/.config/Claude/claude_desktop_config.json`\n\n2. Add this configuration:\n```json\n{\n  \"mcpServers\": {\n    \"8bits-music\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"8-bits-music-mcp\"]\n    }\n  }\n}\n```\n\n3. **Restart Claude Desktop**\n\n4. Look for the 🔌 icon in Claude Desktop - you should see \"8bits-music\" connected!\n\n#### 💻 **Cursor IDE**\n\n1. Go to **Settings** → **Features** → **MCP Servers**\n2. Click **Add MCP Server**\n3. Enter:\n   - **Name:** `8bits-music`\n   - **Command:** `npx`\n   - **Args:** `-y`, `8-bits-music-mcp`\n4. Save and restart Cursor\n\n#### 🔧 **VS Code with MCP Extension**\n\n1. Install the [Model Context Protocol extension](https://marketplace.visualstudio.com/items?itemName=modelcontextprotocol.mcp)\n2. Open settings (`Ctrl+,` or `Cmd+,`)\n3. Search for \"MCP Servers\"\n4. Add to `settings.json`:\n```json\n{\n  \"mcp.servers\": {\n    \"8bits-music\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"8-bits-music-mcp\"]\n    }\n  }\n}\n```\n5. Reload VS Code\n\n### Step 3: Start Creating Music! 🎮\n\nOpen your AI assistant and try:\n\n> *\"Create a retro game theme song with a catchy melody at 140 BPM using a square wave\"*\n\n> *\"Make an 8-bit boss battle theme with drums and export it as WAV\"*\n\n> *\"Generate a calm exploration theme in C major with triangle waves\"*\n\nThat's it! Your AI can now compose 8-bit music! 🎉\n\n---\n\n## 📋 Table of Contents\n\n- [What Can It Do?](#-what-can-it-do)\n- [Usage Examples](#-usage-examples)\n- [Available Tools](#-available-tools)\n- [Instruments & Sounds](#-instruments--sounds)\n- [Music Theory Guide](#-music-theory-guide)\n- [Troubleshooting](#-troubleshooting)\n- [Advanced Configuration](#-advanced-configuration)\n- [For Developers](#-for-developers)\n\n## ✨ What Can It Do?\n\nYour AI assistant can now:\n\n| Capability | Description | Example |\n|------------|-------------|---------|\n| 🎹 **Create Melodies** | Compose custom note sequences with any instrument | \"Make a happy melody in C major\" |\n| 🥁 **Generate Rhythms** | Add drum patterns and percussion | \"Add techno drums at 130 BPM\" |\n| 🎶 **Chord Progressions** | Create harmonies based on music theory | \"Generate a I-V-vi-IV progression\" |\n| 💾 **Export Audio** | Save compositions as WAV or MIDI files | \"Export this as game-theme.wav\" |\n| 🎮 **Game Music Styles** | Create authentic retro game soundtracks | \"Make a Super Mario style theme\" |\n\n## 🎵 Usage Examples\n\n### Example 1: Your First 8-Bit Song\n\nJust ask your AI assistant:\n\n```\nCreate a simple 8-bit melody with these notes: C4, E4, G4, C5 \nusing quarter notes and a square wave at 120 BPM\n```\n\nThe AI will use the MCP server to generate the music and give you a track ID!\n\n### Example 2: Complete Game Theme\n\n```\nI need a retro platformer game theme:\n1. Main melody with square wave\n2. Bass line with triangle wave  \n3. Techno drums\n4. Export everything as \"platformer-theme.wav\"\n```\n\nThe AI will:\n- Create the melody using `create_8bit_melody`\n- Add bass using another `create_8bit_melody` call\n- Generate drums with `create_8bit_rhythm`\n- Export the mix with `export_audio_composition`\n\n### Example 3: Boss Battle Music\n\n```\nCreate an intense boss battle theme:\n- Fast tempo (160 BPM)\n- Aggressive sawtooth lead\n- Heavy drum pattern\n- Dark chord progression\n```\n\n### Example 4: Interactive Composition\n\n```\nStart with a C major scale melody, then:\n1. Add a I-V-vi-IV chord progression\n2. Layer some drums\n3. Show me the track details\n4. Export as MIDI so I can edit it\n```\n\nThe AI handles all the technical details - you just describe what you want!\n\n## 🎮 Available Tools\n\nThe MCP server provides these tools to your AI assistant:\n\n### 🎹 create_8bit_melody\nCreates melodic sequences with authentic 8-bit sounds.\n\n**AI can specify:**\n- Musical notes (e.g., C4, E4, G4)\n- Note durations (quarter, eighth, half notes)\n- Instrument type (square, triangle, sawtooth, pulse, noise)\n- Tempo (60-200 BPM)\n\n### 🥁 create_8bit_rhythm\nGenerates drum and percussion patterns.\n\n**Available patterns:**\n- `basic_rock` - Classic rock beat\n- `techno` - Electronic four-on-the-floor\n- `waltz` - 3/4 time signature\n- `custom` - AI-designed patterns\n\n### 🎶 generate_chord_progression\nCreates chord progressions based on music theory.\n\n**Common progressions:**\n- `I-V-vi-IV` - Pop/rock (C-G-Am-F)\n- `I-IV-V-I` - Classic rock\n- `ii-V-I` - Jazz standard\n- `I-vi-IV-V` - 50s progression\n\n### 💾 export_audio_composition\nExports your creation to audio files.\n\n**Formats:**\n- `WAV` - High quality audio\n- `MIDI` - Editable in music software\n\n## 🎹 Instruments & Sounds\n\n| Instrument | Sound | Best For | Famous Games |\n|------------|-------|----------|--------------|\n| **Square Wave** | `□` Bright, punchy | Lead melodies, main themes | Super Mario Bros, Mega Man |\n| **Triangle Wave** | `△` Smooth, mellow | Bass lines, gentle leads | The Legend of Zelda, Metroid |\n| **Sawtooth Wave** | `⊿` Rich, aggressive | Power chords, intense leads | Castlevania |\n| **Pulse Wave** | `▭` Thin, authentic NES | Arpeggios, harmonies | Final Fantasy |\n| **Noise** | `⚡` Random, percussive | Drums, explosions, effects | All retro games |\n\n### Sound Examples\n\n**Square Wave:** The iconic \"beep\" sound - bright and clear\n```\nPerfect for: Main melodies, catchy hooks, Mario-style themes\n```\n\n**Triangle Wave:** Smooth and bass-heavy\n```\nPerfect for: Bass lines, underwater themes, atmospheric sounds\n```\n\n**Sawtooth Wave:** Rich in harmonics, powerful\n```\nPerfect for: Action themes, aggressive leads, rock-style music\n```\n\n## 🎼 Music Theory Guide\n\nDon't worry if you're not a musician! Here's what the AI understands:\n\n### Common Scales\n- **Major Scale:** Happy, bright (Do-Re-Mi-Fa-Sol-La-Ti-Do)\n- **Minor Scale:** Sad, dark, emotional\n- **Pentatonic:** Simple, Asian-influenced, always sounds good\n- **Blues Scale:** Soulful, expressive\n\n### Popular Chord Progressions\n\n**I-V-vi-IV** (Pop Magic)\n```\nExamples: \"Don't Stop Believin'\", \"Let It Be\"\nUse for: Emotional, singalong themes\n```\n\n**I-IV-V** (Rock Classic)\n```\nExamples: \"La Bamba\", \"Twist and Shout\"  \nUse for: Upbeat, energetic themes\n```\n\n**vi-IV-I-V** (Sad Progression)\n```\nExamples: \"Grenade\", \"Apologize\"\nUse for: Melancholic, emotional scenes\n```\n\n### Tempo Guide\n- **60-80 BPM:** Slow, atmospheric (menu music)\n- **90-120 BPM:** Moderate (exploration themes)\n- **130-160 BPM:** Fast (action levels)\n- **160-200 BPM:** Very fast (boss battles)\n\n## 🔧 Troubleshooting\n\n### \"MCP server not connecting\"\n\n**Windows:**\n1. Open Command Prompt and run: `npx 8-bits-music-mcp`\n2. If you see \"8-Bits Music MCP Server running on stdio\" - the server works!\n3. Check your config file path: `%APPDATA%\\Claude\\claude_desktop_config.json`\n4. Make sure you used **double backslashes** if using absolute paths\n5. Restart Claude Desktop completely\n\n**macOS/Linux:**\n1. Test the server: `npx 8-bits-music-mcp`\n2. Check config: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)\n3. Verify Node.js version: `node --version` (needs 18+)\n\n### \"Package not found\" error\n\n```bash\n# Clear npm cache\nnpm cache clean --force\n\n# Try installing globally first\nnpm install -g 8-bits-music-mcp\n\n# Then use in config\n{\n  \"mcpServers\": {\n    \"8bits-music\": {\n      \"command\": \"8-bits-music-mcp\"\n    }\n  }\n}\n```\n\n### \"Module not found\" error\n\nThe package is updating. Wait a few minutes and try:\n```bash\nnpx clear-npx-cache\nnpx 8-bits-music-mcp\n```\n\n### Server starts but AI can't use it\n\n1. Check the 🔌 icon in Claude Desktop - is \"8bits-music\" listed?\n2. Try asking: *\"What MCP servers are available?\"*\n3. Restart your AI assistant completely\n4. Check server logs in Claude Desktop settings\n\n### Still having issues?\n\n- 📖 [Check the full documentation](https://github.com/ZwitterKaneda/8-bits-music-mcp/issues)\n- 🐛 [Report a bug](https://github.com/ZwitterKaneda/8-bits-music-mcp/issues/new)\n- 💬 [Ask the community](https://github.com/ZwitterKaneda/8-bits-music-mcp/discussions)\n\n## ⚙️ Advanced Configuration\n\n### Using a Specific Version\n\n```json\n{\n  \"mcpServers\": {\n    \"8bits-music\": {\n      \"command\": \"npx\",\n      \"args\": [\"8-bits-music-mcp@1.0.4\"]\n    }\n  }\n}\n```\n\n### Local Installation (Faster)\n\n```bash\n# Install globally\nnpm install -g 8-bits-music-mcp\n\n# Use in config\n{\n  \"mcpServers\": {\n    \"8bits-music\": {\n      \"command\": \"8-bits-music-mcp\"\n    }\n  }\n}\n```\n\n### Environment Variables\n\n```json\n{\n  \"mcpServers\": {\n    \"8bits-music\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"8-bits-music-mcp\"],\n      \"env\": {\n        \"NODE_ENV\": \"production\",\n        \"OUTPUT_DIR\": \"/path/to/music/folder\"\n      }\n    }\n  }\n}\n```\n\n## 👨‍💻 For Developers\n\n### Want to contribute or customize?\n\n```bash\n# Clone the repository\ngit clone https://github.com/ZwitterKaneda/8-bits-music-mcp.git\ncd 8-bits-music-mcp\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Test locally\nnode packages/mcp-server/dist/server.js\n```\n\n### Project Structure\n\n```\n8-bits-music-mcp/\n├── packages/\n│   ├── mcp-server/          # MCP protocol implementation\n│   └── audio-engine/        # 8-bit audio synthesis\n├── examples/                # Usage examples\n└── docs/                    # Full documentation\n```\n\n### Tech Stack\n\n- **MCP Server:** TypeScript, @modelcontextprotocol/sdk\n- **Audio Engine:** Tone.js for Web Audio API synthesis\n- **Build:** TypeScript with ES modules\n- **Runtime:** Node.js 18+\n\n### API Documentation\n\nFull API docs available at: [API Reference](https://github.com/ZwitterKaneda/8-bits-music-mcp/blob/main/docs/API.md)\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how:\n\n1. Fork the repo\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Make your changes\n4. Run tests: `npm test`\n5. Commit: `git commit -m 'Add amazing feature'`\n6. Push: `git push origin feature/amazing-feature`\n7. Open a Pull Request\n\n## 📊 Stats\n\n![npm downloads](https://img.shields.io/npm/dt/8-bits-music-mcp)\n![GitHub stars](https://img.shields.io/github/stars/ZwitterKaneda/8-bits-music-mcp?style=social)\n![GitHub issues](https://img.shields.io/github/issues/ZwitterKaneda/8-bits-music-mcp)\n\n## 🗺️ Roadmap\n\n### ✅ Version 1.x (Current)\n- Basic melody generation\n- Rhythm patterns\n- Chord progressions\n- WAV/MIDI export\n\n### 🚧 Version 2.0 (Coming Soon)\n- Real-time audio preview\n- More instrument types\n- Audio effects (reverb, delay, distortion)\n- Pattern sequencer\n- Visual waveform display\n\n### 💭 Version 3.0 (Future)\n- Multi-track mixing console\n- VST plugin support\n- Cloud rendering\n- Collaborative composition\n- Web-based editor\n\n## ❓ FAQ\n\n**Q: Do I need to install anything besides Node.js?**  \nA: Nope! Just Node.js 18+ and the npx command (comes with Node.js).\n\n**Q: Can I use this commercially?**  \nA: Yes! MIT License allows commercial use.\n\n**Q: Does it work on Linux/Mac/Windows?**  \nA: Yes, all platforms with Node.js 18+ are supported.\n\n**Q: Can I export to MP3?**  \nA: Currently only WAV and MIDI. Use external tools like FFmpeg to convert WAV to MP3.\n\n**Q: How do I make the AI create specific styles?**  \nA: Just describe what you want! Try: \"Create a Mega Man style boss theme\" or \"Make a Zelda dungeon atmosphere\"\n\n**Q: Can I edit the exported files?**  \nA: Yes! Export as MIDI to edit in any DAW (Ableton, FL Studio, Logic, etc.)\n\n**Q: Is internet required?**  \nA: Only for the first install. After that, it works offline.\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n**TL;DR:** Use it however you want, commercially or personally. No restrictions!\n\n## 🙏 Acknowledgments\n\n- **[Anthropic](https://anthropic.com)** - For creating the Model Context Protocol\n- **[Tone.js](https://tonejs.github.io/)** - Amazing Web Audio framework\n- **Koji Kondo** - Nintendo composer who defined 8-bit music\n- **The Chiptune Community** - For keeping retro music alive\n\n## 👨‍💻 Author\n\n**Daniel Díaz** ([@ZwitterKaneda](https://github.com/ZwitterKaneda))\n\n## 📞 Support\n\n- 🐛 **Bug Reports:** [GitHub Issues](https://github.com/ZwitterKaneda/8-bits-music-mcp/issues)\n- 💡 **Feature Requests:** [GitHub Discussions](https://github.com/ZwitterKaneda/8-bits-music-mcp/discussions)\n- ⭐ **Star this project** if you find it useful!\n\n---\n\n<div align=\"center\">\n\n## **Ready to create 8-bit magic? 🎮✨**\n\nAdd this to your AI assistant and start composing retro game music in seconds!\n\n```json\n{\n  \"mcpServers\": {\n    \"8bits-music\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"8-bits-music-mcp\"]\n    }\n  }\n}\n```\n\n**[Get Started Now](#-quick-start-2-minutes)** • **[Report Bug](https://github.com/ZwitterKaneda/8-bits-music-mcp/issues)** • **[Request Feature](https://github.com/ZwitterKaneda/8-bits-music-mcp/issues)**\n\n---\n\n*Made with ❤️ and lots of ☕ by the 8-bits-music-mcp team*\n\n**Happy chiptune composing! 🎵🎮**\n\n</div>\n","readmeFilename":"README.md"}