gandr-mcp 0.1.0__tar.gz

gandr_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gandr
+
+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.

gandr_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: gandr-mcp
+Version: 0.1.0
+Summary: The official Gandr MCP server, text to speech inside any MCP-compatible agent
+Author-email: Gandr <team@gandr.ai>
+License: MIT
+Project-URL: Homepage, https://gandr.ai
+Project-URL: Repository, https://github.com/Gandr-AI/gandr-mcp
+Keywords: mcp,tts,text-to-speech,voice-ai,agents
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0
+Dynamic: license-file
+
+# gandr-mcp
+
+The official **Gandr MCP server**, text to speech inside any MCP-compatible agent (Claude Desktop, Cursor, and friends).
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `synthesize` | Render text to speech (WAV, base64). Voices, sample rate 8000-48000, pitch and pacing dials |
+| `list_voices` | The six stock voices |
+| `get_usage` | Characters used by the configured key |
+
+## Run
+
+```bash
+pip install mcp
+GANDR_API_KEY=gnd_... python server.py
+```
+
+Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "gandr": {
+      "command": "python",
+      "args": ["/path/to/server.py"],
+      "env": { "GANDR_API_KEY": "gnd_..." }
+    }
+  }
+}
+```
+
+Get a key at [gandr.ai](https://gandr.ai). Docs: [gandr.ai/docs](https://gandr.ai/docs).

gandr_mcp-0.1.0/README.md

@@ -0,0 +1,34 @@
+# gandr-mcp
+
+The official **Gandr MCP server**, text to speech inside any MCP-compatible agent (Claude Desktop, Cursor, and friends).
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `synthesize` | Render text to speech (WAV, base64). Voices, sample rate 8000-48000, pitch and pacing dials |
+| `list_voices` | The six stock voices |
+| `get_usage` | Characters used by the configured key |
+
+## Run
+
+```bash
+pip install mcp
+GANDR_API_KEY=gnd_... python server.py
+```
+
+Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "gandr": {
+      "command": "python",
+      "args": ["/path/to/server.py"],
+      "env": { "GANDR_API_KEY": "gnd_..." }
+    }
+  }
+}
+```
+
+Get a key at [gandr.ai](https://gandr.ai). Docs: [gandr.ai/docs](https://gandr.ai/docs).

gandr_mcp-0.1.0/gandr_mcp.egg-info/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: gandr-mcp
+Version: 0.1.0
+Summary: The official Gandr MCP server, text to speech inside any MCP-compatible agent
+Author-email: Gandr <team@gandr.ai>
+License: MIT
+Project-URL: Homepage, https://gandr.ai
+Project-URL: Repository, https://github.com/Gandr-AI/gandr-mcp
+Keywords: mcp,tts,text-to-speech,voice-ai,agents
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0
+Dynamic: license-file
+
+# gandr-mcp
+
+The official **Gandr MCP server**, text to speech inside any MCP-compatible agent (Claude Desktop, Cursor, and friends).
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `synthesize` | Render text to speech (WAV, base64). Voices, sample rate 8000-48000, pitch and pacing dials |
+| `list_voices` | The six stock voices |
+| `get_usage` | Characters used by the configured key |
+
+## Run
+
+```bash
+pip install mcp
+GANDR_API_KEY=gnd_... python server.py
+```
+
+Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "gandr": {
+      "command": "python",
+      "args": ["/path/to/server.py"],
+      "env": { "GANDR_API_KEY": "gnd_..." }
+    }
+  }
+}
+```
+
+Get a key at [gandr.ai](https://gandr.ai). Docs: [gandr.ai/docs](https://gandr.ai/docs).

gandr_mcp-0.1.0/gandr_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+server.py
+gandr_mcp.egg-info/PKG-INFO
+gandr_mcp.egg-info/SOURCES.txt
+gandr_mcp.egg-info/dependency_links.txt
+gandr_mcp.egg-info/requires.txt
+gandr_mcp.egg-info/top_level.txt

gandr_mcp-0.1.0/gandr_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gandr_mcp-0.1.0/gandr_mcp.egg-info/requires.txt

@@ -0,0 +1 @@
+mcp>=1.0

gandr_mcp-0.1.0/gandr_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+server

gandr_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gandr-mcp"
+version = "0.1.0"
+description = "The official Gandr MCP server, text to speech inside any MCP-compatible agent"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [{name = "Gandr", email = "team@gandr.ai"}]
+keywords = ["mcp", "tts", "text-to-speech", "voice-ai", "agents"]
+dependencies = ["mcp>=1.0"]
+
+[project.urls]
+Homepage = "https://gandr.ai"
+Repository = "https://github.com/Gandr-AI/gandr-mcp"

gandr_mcp-0.1.0/server.py

@@ -0,0 +1,104 @@
+"""gandr-mcp, the Gandr TTS MCP server.
+
+Puts text-to-speech inside any MCP-compatible agent (Claude Desktop, Cursor,
+and friends) as three tools: synthesize, list_voices, get_usage.
+
+Run it:
+    pip install mcp
+    GANDR_API_KEY=gnd_... python server.py
+
+Claude Desktop config:
+    {
+      "mcpServers": {
+        "gandr": {
+          "command": "python",
+          "args": ["/path/to/server.py"],
+          "env": {"GANDR_API_KEY": "gnd_..."}
+        }
+      }
+    }
+"""
+
+from __future__ import annotations
+
+import base64
+import json
+import os
+import urllib.request
+
+from mcp.server.fastmcp import FastMCP
+
+DOOR = os.environ.get("GANDR_DOOR", "https://tts.gandr.ai")
+KEY = os.environ.get("GANDR_API_KEY", "")
+
+mcp = FastMCP("gandr")
+
+VOICES = ["gandr-ava", "gandr-dane", "gandr-jenny",
+          "gandr-leo", "gandr-lewis", "gandr-mia"]
+
+
+def _call(path: str, body: dict | None) -> bytes:
+    req = urllib.request.Request(
+        DOOR + path,
+        data=json.dumps(body).encode() if body is not None else None,
+        method="POST" if body is not None else "GET",
+        headers={"x-api-key": KEY, "content-type": "application/json"},
+    )
+    with urllib.request.urlopen(req, timeout=60) as r:
+        return r.read()
+
+
+@mcp.tool()
+def synthesize(
+    text: str,
+    voice: str = "gandr-ava",
+    sample_rate: int = 24000,
+    temperature: float | None = None,
+    cfg_weight: float | None = None,
+) -> str:
+    """Render text to speech. Returns the WAV audio base64-encoded.
+
+    voice: one of gandr-ava, gandr-dane, gandr-jenny, gandr-leo, gandr-lewis,
+    gandr-mia. temperature: 0.1-1.2 pitch range (omit for the tuned default).
+    cfg_weight: 0.2-1.0 pacing. sample_rate: 8000-48000.
+    """
+    if not text.strip():
+        return "error: text must not be empty"
+    if len(text) > 2000:
+        return "error: 2000-character request cap, split the text"
+    body: dict = {
+        "transcript": text,
+        "language": "en",
+        "voice": {"mode": "id", "id": voice},
+        "output_format": {"sample_rate": sample_rate},
+    }
+    if temperature is not None:
+        body["temperature"] = temperature
+    if cfg_weight is not None:
+        body["cfg_weight"] = cfg_weight
+    try:
+        audio = _call("/v1/tts/bytes", body)
+    except Exception as e:  # the door's own message is the useful part
+        return f"error: {e}"
+    return base64.b64encode(audio).decode()
+
+
+@mcp.tool()
+def list_voices() -> str:
+    """List the available Gandr voices with their ids."""
+    return "\n".join(VOICES)
+
+
+@mcp.tool()
+def get_usage() -> str:
+    """Characters used vs quota for the configured API key."""
+    try:
+        return _call("/v1/usage", None).decode()
+    except Exception as e:
+        return f"error: {e}"
+
+
+if __name__ == "__main__":
+    if not KEY:
+        raise SystemExit("GANDR_API_KEY is not set, get a key at https://gandr.ai")
+    mcp.run()

gandr_mcp-0.1.0/setup.cfg

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