sonilo-mcp 0.1.0__tar.gz

sonilo_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sonilo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sonilo_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: sonilo-mcp
+Version: 0.1.0
+Summary: MCP server for Sonilo AI music generation API
+Home-page: https://github.com/sonilo-ai/sonilo-api-dashboard
+Author: Sonilo
+Author-email: Sonilo <support@sonilo.com>
+License: MIT
+Project-URL: Homepage, https://platform.sonilo.com
+Project-URL: Repository, https://github.com/sonilo-ai/sonilo-mcp
+Keywords: sonilo,mcp,music,ai,audio,video-to-music
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: sounddevice>=0.5.1
+Requires-Dist: soundfile>=0.13.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: respx>=0.21; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Sonilo MCP Server
+
+An MCP (Model Context Protocol) server that exposes [Sonilo](https://platform.sonilo.com)'s AI music generation API to MCP-compatible clients (Claude Desktop, Cursor, etc.).
+
+## Install
+
+```bash
+uvx sonilo-mcp
+```
+
+Or install with pip:
+
+```bash
+pip install sonilo-mcp
+```
+
+### Audio Playback Dependencies
+
+The `play_audio` tool requires PortAudio at runtime (for `sounddevice`). On macOS/Linux, install via:
+
+- **macOS**: `brew install portaudio`
+- **Debian/Ubuntu**: `sudo apt-get install libportaudio2`
+
+`uvx sonilo-mcp` and `pip install` will pull the Python bindings, but the system PortAudio library must be installed separately. The other tools (`text_to_music`, `video_to_music`, `get_account_services`, `get_usage`) work without PortAudio.
+
+## Configuration
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "sonilo": {
+      "command": "uvx",
+      "args": ["sonilo-mcp"],
+      "env": {
+        "SONILO_API_KEY": "sk_live_..."
+      }
+    }
+  }
+}
+```
+
+Get your API key at <https://platform.sonilo.com/dashboard/api-keys>.
+
+### Codex
+
+Add the server to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.sonilo]
+command = "uvx"
+args = ["sonilo-mcp"]
+
+[mcp_servers.sonilo.env]
+SONILO_API_KEY = "sk_live_..."
+```
+
+Restart Codex (or start a new session) to load it, then run `/mcp` to confirm
+`sonilo` is connected and its tools are listed.
+
+### Environment Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `SONILO_API_KEY` | _(required)_ | Bearer token. |
+| `SONILO_API_URL` | `https://api.sonilo.com` | Public API base URL. |
+| `SONILO_MCP_BASE_PATH` | `~/Desktop` | Default output directory and base for relative input paths. Also the confinement boundary (see below). |
+| `SONILO_MCP_ALLOW_ANY_PATH` | `false` | Set to `true` to let tools read/write files outside `SONILO_MCP_BASE_PATH`. |
+| `TIME_OUT_SECONDS` | `300` | Generation timeout. |
+
+### File access & confinement
+
+By default, the file tools (`video_to_music` input, `play_audio`, and any
+`output_directory`) are **confined to `SONILO_MCP_BASE_PATH`**. Paths that
+resolve outside it (after symlink resolution) are rejected. This limits the
+blast radius if a client is tricked into reading or exfiltrating arbitrary
+files. To opt out — e.g. to read a video from elsewhere on disk — set
+`SONILO_MCP_ALLOW_ANY_PATH=true`.
+
+## Tools
+
+| Tool | Description | Cost |
+|---|---|---|
+| `text_to_music(prompt, duration, output_directory?)` | Generate music from a text prompt. | ✅ |
+| `video_to_music(video_path? \| video_url?, prompt?, output_directory?)` | Generate music matched to a video. | ✅ |
+| `get_account_services()` | List available services and limits. | ❌ |
+| `get_usage(days=30)` | Show usage summary + per-day breakdown. | ❌ |
+| `play_audio(input_file_path)` | Play a local audio file. | ❌ |
+
+Tools marked ✅ make API calls that incur charges on your Sonilo account.
+
+## Output Format
+
+Generated audio is saved as `.m4a` (AAC in MP4 container — this is what the backend currently emits). File names use the title returned by the backend (slugified) or a `sonilo-<timestamp>.m4a` fallback. When multiple parallel streams are returned, a `-<index>` suffix is appended.
+
+## Common Errors
+
+| Message | What to do |
+|---|---|
+| `Invalid SONILO_API_KEY` | Verify the key at <https://platform.sonilo.com/dashboard/api-keys>. |
+| `Insufficient minutes` / `Credit limit exceeded` | Top up at <https://platform.sonilo.com/dashboard/billing>. |
+| `Rate limit exceeded` | Check `get_account_services` for your rpm/concurrency limits. |
+| `Generation timed out` | Raise `TIME_OUT_SECONDS`. Check `get_usage` to confirm whether the backend completed and charged. |
+
+## Development
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

sonilo_mcp-0.1.0/README.md

@@ -0,0 +1,119 @@
+# Sonilo MCP Server
+
+An MCP (Model Context Protocol) server that exposes [Sonilo](https://platform.sonilo.com)'s AI music generation API to MCP-compatible clients (Claude Desktop, Cursor, etc.).
+
+## Install
+
+```bash
+uvx sonilo-mcp
+```
+
+Or install with pip:
+
+```bash
+pip install sonilo-mcp
+```
+
+### Audio Playback Dependencies
+
+The `play_audio` tool requires PortAudio at runtime (for `sounddevice`). On macOS/Linux, install via:
+
+- **macOS**: `brew install portaudio`
+- **Debian/Ubuntu**: `sudo apt-get install libportaudio2`
+
+`uvx sonilo-mcp` and `pip install` will pull the Python bindings, but the system PortAudio library must be installed separately. The other tools (`text_to_music`, `video_to_music`, `get_account_services`, `get_usage`) work without PortAudio.
+
+## Configuration
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "sonilo": {
+      "command": "uvx",
+      "args": ["sonilo-mcp"],
+      "env": {
+        "SONILO_API_KEY": "sk_live_..."
+      }
+    }
+  }
+}
+```
+
+Get your API key at <https://platform.sonilo.com/dashboard/api-keys>.
+
+### Codex
+
+Add the server to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.sonilo]
+command = "uvx"
+args = ["sonilo-mcp"]
+
+[mcp_servers.sonilo.env]
+SONILO_API_KEY = "sk_live_..."
+```
+
+Restart Codex (or start a new session) to load it, then run `/mcp` to confirm
+`sonilo` is connected and its tools are listed.
+
+### Environment Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `SONILO_API_KEY` | _(required)_ | Bearer token. |
+| `SONILO_API_URL` | `https://api.sonilo.com` | Public API base URL. |
+| `SONILO_MCP_BASE_PATH` | `~/Desktop` | Default output directory and base for relative input paths. Also the confinement boundary (see below). |
+| `SONILO_MCP_ALLOW_ANY_PATH` | `false` | Set to `true` to let tools read/write files outside `SONILO_MCP_BASE_PATH`. |
+| `TIME_OUT_SECONDS` | `300` | Generation timeout. |
+
+### File access & confinement
+
+By default, the file tools (`video_to_music` input, `play_audio`, and any
+`output_directory`) are **confined to `SONILO_MCP_BASE_PATH`**. Paths that
+resolve outside it (after symlink resolution) are rejected. This limits the
+blast radius if a client is tricked into reading or exfiltrating arbitrary
+files. To opt out — e.g. to read a video from elsewhere on disk — set
+`SONILO_MCP_ALLOW_ANY_PATH=true`.
+
+## Tools
+
+| Tool | Description | Cost |
+|---|---|---|
+| `text_to_music(prompt, duration, output_directory?)` | Generate music from a text prompt. | ✅ |
+| `video_to_music(video_path? \| video_url?, prompt?, output_directory?)` | Generate music matched to a video. | ✅ |
+| `get_account_services()` | List available services and limits. | ❌ |
+| `get_usage(days=30)` | Show usage summary + per-day breakdown. | ❌ |
+| `play_audio(input_file_path)` | Play a local audio file. | ❌ |
+
+Tools marked ✅ make API calls that incur charges on your Sonilo account.
+
+## Output Format
+
+Generated audio is saved as `.m4a` (AAC in MP4 container — this is what the backend currently emits). File names use the title returned by the backend (slugified) or a `sonilo-<timestamp>.m4a` fallback. When multiple parallel streams are returned, a `-<index>` suffix is appended.
+
+## Common Errors
+
+| Message | What to do |
+|---|---|
+| `Invalid SONILO_API_KEY` | Verify the key at <https://platform.sonilo.com/dashboard/api-keys>. |
+| `Insufficient minutes` / `Credit limit exceeded` | Top up at <https://platform.sonilo.com/dashboard/billing>. |
+| `Rate limit exceeded` | Check `get_account_services` for your rpm/concurrency limits. |
+| `Generation timed out` | Raise `TIME_OUT_SECONDS`. Check `get_usage` to confirm whether the backend completed and charged. |
+
+## Development
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

sonilo_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[project]
+name = "sonilo-mcp"
+version = "0.1.0"
+description = "MCP server for Sonilo AI music generation API"
+authors = [{ name = "Sonilo", email = "support@sonilo.com" }]
+readme = "README.md"
+license = { text = "MIT" }
+keywords = ["sonilo", "mcp", "music", "ai", "audio", "video-to-music"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "mcp[cli]>=1.6.0",
+    "httpx>=0.27",
+    "sounddevice>=0.5.1",
+    "soundfile>=0.13.1",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.23",
+    "respx>=0.21",
+    "build>=1.2",
+]
+
+[project.scripts]
+sonilo-mcp = "sonilo_mcp.api:main"
+
+[project.urls]
+Homepage = "https://platform.sonilo.com"
+Repository = "https://github.com/sonilo-ai/sonilo-mcp"
+
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

sonilo_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sonilo_mcp-0.1.0/setup.py

@@ -0,0 +1,21 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="sonilo-mcp",
+    version="0.1.0",
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    include_package_data=True,
+    entry_points={
+        "console_scripts": [
+            "sonilo-mcp = sonilo_mcp.api:main",
+        ],
+    },
+    author="Sonilo",
+    author_email="support@sonilo.com",
+    description="MCP server for Sonilo AI music generation API",
+    url="https://github.com/sonilo-ai/sonilo-api-dashboard",
+    python_requires=">=3.10",
+    long_description=open("README.md").read() if __import__("os").path.exists("README.md") else "",
+    long_description_content_type="text/markdown",
+)

sonilo_mcp-0.1.0/src/sonilo_mcp/__init__.py

@@ -0,0 +1,4 @@
+"""Sonilo MCP server package."""
+from .api import main, mcp
+
+__all__ = ["main", "mcp"]

sonilo_mcp-0.1.0/src/sonilo_mcp/__main__.py

@@ -0,0 +1,3 @@
+from sonilo_mcp import main
+
+main()