{"id":28579637,"url":"https://github.com/pinkpixel-dev/blabber-mcp","last_synced_at":"2025-06-11T02:09:16.229Z","repository":{"id":296340117,"uuid":"961231935","full_name":"pinkpixel-dev/blabber-mcp","owner":"pinkpixel-dev","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-30T05:27:04.000Z","size":19,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-30T06:54:53.893Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pinkpixel-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-06T03:46:07.000Z","updated_at":"2025-04-07T02:41:52.000Z","dependencies_parsed_at":"2025-05-30T06:55:10.350Z","dependency_job_id":"fda89d26-5674-44cc-8cdf-f0c872c3f80c","html_url":"https://github.com/pinkpixel-dev/blabber-mcp","commit_stats":null,"previous_names":["pinkpixel-dev/blabber-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fblabber-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fblabber-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fblabber-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fblabber-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pinkpixel-dev","download_url":"https://codeload.github.com/pinkpixel-dev/blabber-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinkpixel-dev%2Fblabber-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259184767,"owners_count":22818271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-11T02:09:09.229Z","updated_at":"2025-06-11T02:09:14.201Z","avatar_url":"https://github.com/pinkpixel-dev.png","language":"JavaScript","funding_links":[],"categories":["Uncategorized"],"sub_categories":["How to Submit"],"readme":"# \u003cspan style=\"color: #FF69B4;\"\u003e📢 Blabber-MCP\u003c/span\u003e \u003cspan style=\"color: #ADD8E6;\"\u003e🗣️\u003c/span\u003e\n\n[![smithery badge](https://smithery.ai/badge/@pinkpixel-dev/blabber-mcp)](https://smithery.ai/server/@pinkpixel-dev/blabber-mcp)\n\n\u003cspan style=\"color: #90EE90;\"\u003eAn MCP server that gives your LLMs a voice using OpenAI's Text-to-Speech API!\u003c/span\u003e 🔊\n\n---\n\n## \u003cspan style=\"color: #FFD700;\"\u003e✨ Features\u003c/span\u003e\n\n*   **Text-to-Speech:** Converts input text into high-quality spoken audio.\n*   **Voice Selection:** Choose from various OpenAI voices (`alloy`, `echo`, `fable`, `onyx`, `nova`, `shimmer`).\n*   **Model Selection:** Use standard (`tts-1`) or high-definition (`tts-1-hd`) models.\n*   **Format Options:** Get audio output in `mp3`, `opus`, `aac`, or `flac`.\n*   **File Saving:** Saves the generated audio to a local file.\n*   **Optional Playback:** Automatically play the generated audio using a configurable system command.\n*   **Configurable Defaults:** Set a default voice via configuration.\n\n---\n\n## \u003cspan style=\"color: #FFA07A;\"\u003e🔧 Configuration\u003c/span\u003e\n\nTo use this server, you need to add its configuration to your MCP client's settings file (e.g., `mcp_settings.json`).\n\n1.  **Get OpenAI API Key:** You need an API key from [OpenAI](https://platform.openai.com/api-keys).\n2.  **Add to MCP Settings:** Add the following block to the `mcpServers` object in your settings file, replacing `\"YOUR_OPENAI_API_KEY\"` with your actual key.\n\n```json\n{\n  \"mcpServers\": {\n    \"blabber-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"/full/path/to/blabber-mcp/build/index.js\"], (IMPORTANT: Use the full, absolute path to the built index.js file)\n      \"env\": {\n        \"OPENAI_API_KEY\": \"YOUR_OPENAI_API_KEY\",\n        \"AUDIO_PLAYER_COMMAND\": \"xdg-open\", (Optional: Command to play audio (e.g., \"cvlc\", \"vlc\", \"mpv\", \"ffplay\", \"afplay\", \"xdg-open\"; defaults to \"cvlc\")\n        \"DEFAULT_TTS_VOICE\": \"nova\" (Optional: Set default voice (alloy, echo, fable, onyx, nova, shimmer); defaults to nova)\n      },\n      \"disabled\": false,\n      \"alwaysAllow\": []\n    }\n  }\n}\n```\n\n\u003cspan style=\"color: #FF6347;\"\u003e**Important:**\u003c/span\u003e Make sure the `args` path points to the correct location of the `build/index.js` file within your `blabber-mcp` project directory. Use the full absolute path.\n\n---\n\n## \u003cspan style=\"color: #87CEEB;\"\u003e🚀 Usage\u003c/span\u003e\n\nOnce configured and running, you can use the `text_to_speech` tool via your MCP client.\n\n**Tool:** `text_to_speech`\n**Server:** `blabber-mcp` (or the key you used in the config)\n\n**Arguments:**\n\n*   `input` (string, **required**): The text to synthesize.\n*   `voice` (string, optional): The voice to use (`alloy`, `echo`, `fable`, `onyx`, `nova`, `shimmer`). Defaults to the `DEFAULT_TTS_VOICE` set in config, or `nova`.\n*   `model` (string, optional): The model (`tts-1`, `tts-1-hd`). Defaults to `tts-1`.\n*   `response_format` (string, optional): Audio format (`mp3`, `opus`, `aac`, `flac`). Defaults to `mp3`.\n*   `play` (boolean, optional): Set to `true` to automatically play the audio after saving. Defaults to `false`.\n\n**Example Tool Call (with playback):**\n\n```xml\n\u003cuse_mcp_tool\u003e\n  \u003cserver_name\u003eblabber-mcp\u003c/server_name\u003e\n  \u003ctool_name\u003etext_to_speech\u003c/tool_name\u003e\n  \u003carguments\u003e\n  {\n    \"input\": \"Hello from Blabber MCP!\",\n    \"voice\": \"shimmer\",\n    \"play\": true\n  }\n  \u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n```\n\n**Output:**\n\nThe tool saves the audio file to the `output/` directory within the `blabber-mcp` project folder and returns a JSON response like this:\n\n```json\n{\n  \"message\": \"Audio saved successfully. Playback initiated using command: cvlc\",\n  \"filePath\": \"path/to/speech_1743908694848.mp3\", \n  \"format\": \"mp3\",\n  \"voiceUsed\": \"shimmer\"\n}\n```\n\n---\n\n## \u003cspan style=\"color: #98FB98;\"\u003e📜 License\u003c/span\u003e\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## \u003cspan style=\"color: #BA55D3;\"\u003e🕒 Changelog\u003c/span\u003e\n\nSee the [CHANGELOG.md](CHANGELOG.md) file for details on version history.\n\n---\n\n\u003cp align=\"center\"\u003eMade with ❤️ by Pink Pixel\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinkpixel-dev%2Fblabber-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpinkpixel-dev%2Fblabber-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinkpixel-dev%2Fblabber-mcp/lists"}