@rxreyn3/speak-mcp 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,88 @@
+# Speak MCP
+
+A local MCP server that rewrites text with Ollama for natural speech and reads it aloud with macOS `say`.
+
+## Requirements
+
+- macOS with the `say` command available.
+- Node.js 18 or newer.
+- Ollama running locally.
+- The configured Ollama model pulled locally.
+
+## Installation
+
+You do not need to clone this repository to use Speak MCP. Configure your MCP client to run the published npm package with `npx`.
+
+## Claude Desktop configuration
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` and add this server under `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "speak": {
+      "command": "npx",
+      "args": ["-y", "@rxreyn3/speak-mcp"],
+      "env": {
+        "OLLAMA_HOST": "http://localhost:11434",
+        "OLLAMA_MODEL": "qwen2.5:7b-instruct"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop after changing the config.
+
+## Local development
+
+For local development from a clone:
+
+```bash
+npm install
+npm run build
+```
+
+Then point your MCP client at the built entrypoint:
+
+```json
+{
+  "mcpServers": {
+    "speak": {
+      "command": "node",
+      "args": ["/absolute/path/to/speak-mcp/dist/index.js"],
+      "env": {
+        "OLLAMA_HOST": "http://localhost:11434",
+        "OLLAMA_MODEL": "qwen2.5:7b-instruct"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### `speak_text`
+
+Reads explicit text aloud. The MCP client must pass the text; this server cannot read the client transcript itself.
+
+```json
+{ "text": "Text to read aloud" }
+```
+
+The server rewrites the text with Ollama before playback. If Ollama is unreachable, returns an MCP tool error and does not speak raw text.
+
+### `stop_speech`
+
+Stops the current macOS `say` playback, if any. This tool does not contact Ollama and does not start replacement audio.
+
+## Prompt
+
+The server registers `read_aloud`, a user-selected prompt that instructs an MCP client to call `speak_text` with visible assistant response text when read-aloud behavior is requested.
+
+## Troubleshooting
+
+- If Claude Desktop does not show the server, confirm Node.js 18+ is installed and restart Claude Desktop after editing the config.
+- If speech does not start, confirm Ollama is running at `OLLAMA_HOST` and the model in `OLLAMA_MODEL` is pulled.
+- Do not add `console.log` to the server: stdout is reserved for MCP JSON-RPC messages. Use `console.error` for diagnostics.
+- Late `say` playback failures are logged to stderr and MCP logging; there is intentionally no `speech_status` tool in v1.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { SpeakMcpServer } from './server.js';
+async function main() {
+    try {
+        const server = new SpeakMcpServer();
+        await server.start();
+    }
+    catch (error) {
+        console.error('Failed to start Speak MCP server:', error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('Unhandled Speak MCP server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACpC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+export declare class SpeakMcpServer {
+    private readonly server;
+    private readonly speech;
+    constructor();
+    start(): Promise<void>;
+    private registerTools;
+    private registerPrompts;
+    private registerShutdownHandlers;
+}

package/dist/server.js

@@ -0,0 +1,98 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { rewriteForSpeech, SpeechController } from './speech.js';
+import { textResult } from './types.js';
+export class SpeakMcpServer {
+    server;
+    speech;
+    constructor() {
+        this.server = new McpServer({ name: 'speak-mcp', version: '0.1.0' }, { capabilities: { tools: {}, prompts: {}, logging: {} } });
+        this.speech = new SpeechController((message) => {
+            console.error(message);
+            if (this.server.isConnected()) {
+                void this.server.sendLoggingMessage({ level: 'error', data: message });
+            }
+        });
+        this.registerTools();
+        this.registerPrompts();
+        this.registerShutdownHandlers();
+    }
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('Speak MCP server running on stdio');
+    }
+    registerTools() {
+        this.server.registerTool('speak_text', {
+            title: 'Speak text',
+            description: 'Rewrite the provided text for natural speech with local Ollama, then read it aloud using macOS say. Pass the exact assistant response or other text to read; the server cannot access the MCP client transcript itself.',
+            inputSchema: {
+                text: z.string().describe('The assistant response or other text to read aloud.'),
+            },
+        }, async ({ text }) => {
+            const source = text.trim();
+            if (!source)
+                return textResult('No text was provided to speak.', true);
+            this.speech.stopCurrent();
+            let rewritten;
+            try {
+                rewritten = await rewriteForSpeech(source);
+            }
+            catch (err) {
+                const cause = err?.cause?.code;
+                const message = cause === 'ECONNREFUSED'
+                    ? 'Ollama is not reachable at the configured host.'
+                    : `Speech rewrite failed: ${err.message}`;
+                return textResult(message, true);
+            }
+            this.speech.speak(rewritten);
+            return textResult('Speech started.');
+        });
+        this.server.registerTool('stop_speech', {
+            title: 'Stop speech',
+            description: 'Stop any speech currently playing from the local macOS say process.',
+            inputSchema: {},
+        }, async () => textResult(this.speech.stopCurrent() ? 'Speech stopped.' : 'No speech is currently playing.'));
+    }
+    registerPrompts() {
+        this.server.registerPrompt('read_aloud', {
+            title: 'Read aloud',
+            description: 'Instructions for using speak_text to read assistant responses aloud.',
+        }, async () => ({
+            description: 'Use the speak_text tool when the user asks to hear text read aloud.',
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: 'When I ask you to read something aloud, call the speak_text tool with the exact text to speak. For a previous assistant response, pass the visible response text. Use stop_speech when I ask you to stop playback.',
+                    },
+                },
+            ],
+        }));
+    }
+    registerShutdownHandlers() {
+        const stopPlayback = () => {
+            this.speech.stopCurrent();
+        };
+        const shutdown = async (signal) => {
+            stopPlayback();
+            try {
+                await this.server.close();
+            }
+            catch (err) {
+                console.error(`Failed to close MCP server after ${signal}:`, err);
+            }
+            process.exit(0);
+        };
+        process.once('SIGINT', () => {
+            void shutdown('SIGINT');
+        });
+        process.once('SIGTERM', () => {
+            void shutdown('SIGTERM');
+        });
+        process.once('beforeExit', stopPlayback);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/speech.d.ts

@@ -0,0 +1,13 @@
+import type { PlaybackState } from './types.js';
+export declare const rewriteForSpeech: (text: string) => Promise<string>;
+type PlaybackLogger = (message: string) => void | Promise<void>;
+export declare class SpeechController {
+    private readonly log;
+    private current;
+    private state;
+    constructor(log?: PlaybackLogger);
+    getState(): PlaybackState;
+    stopCurrent(): boolean;
+    speak(rewrittenText: string): void;
+}
+export {};

package/dist/speech.js

@@ -0,0 +1,95 @@
+import { spawn } from 'node:child_process';
+const DEFAULT_MODEL = 'qwen2.5:7b-instruct';
+const DEFAULT_HOST = 'http://localhost:11434';
+const REWRITE_TIMEOUT_MS = 60_000;
+const SPEECH_SYSTEM_PROMPT = [
+    "You rewrite an AI assistant's chat response so it can be read aloud by a text-to-speech engine.",
+    'Narrate the prose naturally, as if explaining it out loud.',
+    'Do NOT read code verbatim. When you encounter a code block, briefly describe in one or two spoken sentences what the code does — never spell out syntax, punctuation, or individual symbols.',
+    'Reduce markdown, URLs, and file paths to their spoken essence.',
+    'Output only the spoken text — no preamble, no headings, no markup.',
+].join(' ');
+export const rewriteForSpeech = async (text) => {
+    const host = (process.env.OLLAMA_HOST?.trim() || DEFAULT_HOST).replace(/\/$/, '');
+    const model = process.env.OLLAMA_MODEL?.trim() || DEFAULT_MODEL;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), REWRITE_TIMEOUT_MS);
+    try {
+        const res = await fetch(`${host}/api/chat`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model,
+                stream: false,
+                messages: [
+                    { role: 'system', content: SPEECH_SYSTEM_PROMPT },
+                    { role: 'user', content: text },
+                ],
+                options: { temperature: 0, seed: 42, num_predict: 4096 },
+            }),
+            signal: controller.signal,
+        });
+        const body = (await res.json().catch(() => null));
+        if (!res.ok) {
+            const detail = body?.error ? `: ${body.error}` : '';
+            throw new Error(`Ollama returned status ${res.status}${detail}`);
+        }
+        const rewritten = body?.message?.content?.trim();
+        if (!rewritten)
+            throw new Error('Ollama returned an empty rewrite');
+        return rewritten;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+export class SpeechController {
+    log;
+    current = null;
+    state = { status: 'idle' };
+    constructor(log = (message) => console.error(message)) {
+        this.log = log;
+    }
+    getState() {
+        return this.state;
+    }
+    stopCurrent() {
+        if (!this.current)
+            return false;
+        this.current.kill();
+        this.current = null;
+        this.state = { status: 'idle', lastError: this.state.lastError };
+        return true;
+    }
+    speak(rewrittenText) {
+        this.stopCurrent();
+        const child = spawn('say', [], { stdio: ['pipe', 'ignore', 'ignore'] });
+        this.current = child;
+        this.state = { status: 'playing', startedAt: new Date() };
+        child.on('error', (err) => {
+            if (this.current !== child)
+                return;
+            this.current = null;
+            const message = `Could not run 'say': ${err.message}`;
+            this.state = { status: 'idle', lastError: message };
+            void this.log(message);
+        });
+        child.on('close', (code) => {
+            if (this.current === child) {
+                this.current = null;
+                if (code) {
+                    const message = `'say' exited with code ${code}`;
+                    this.state = { status: 'idle', lastError: message };
+                    void this.log(message);
+                    return;
+                }
+                this.state = { status: 'idle' };
+            }
+        });
+        child.stdin?.on('error', () => {
+            // Ignore EPIPE if the child was killed mid-write.
+        });
+        child.stdin?.end(rewrittenText);
+    }
+}
+//# sourceMappingURL=speech.js.map

package/dist/speech.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.js","sourceRoot":"","sources":["../src/speech.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,17 @@
+export type TextContent = {
+    type: 'text';
+    text: string;
+};
+export type ToolTextResult = {
+    content: TextContent[];
+    isError?: boolean;
+};
+export type PlaybackState = {
+    status: 'idle';
+    lastError?: string;
+} | {
+    status: 'playing';
+    startedAt: Date;
+    lastError?: string;
+};
+export declare const textResult: (text: string, isError?: boolean) => ToolTextResult;

package/dist/types.js

@@ -0,0 +1,5 @@
+export const textResult = (text, isError = false) => ({
+    content: [{ type: 'text', text }],
+    ...(isError ? { isError: true } : {}),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,OAAO,GAAG,KAAK,EAAkB,EAAE,CAAC,CAAC;IAC5E,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACtC,CAAC,CAAC"}

package/examples/claude_desktop_config.example.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "speak": {
+      "command": "npx",
+      "args": ["-y", "@rxreyn3/speak-mcp"],
+      "env": {
+        "OLLAMA_HOST": "http://localhost:11434",
+        "OLLAMA_MODEL": "qwen2.5:7b-instruct"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@rxreyn3/speak-mcp",
+  "version": "0.1.0",
+  "description": "Local MCP server for Ollama-rewritten macOS speech playback",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "speak-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run typecheck && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "tts",
+    "ollama",
+    "speech",
+    "read-aloud",
+    "macos"
+  ],
+  "author": "Ryan Reynolds",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "examples"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.30",
+    "typescript": "^5.8.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rxreyn3/speak-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rxreyn3/speak-mcp/issues"
+  },
+  "homepage": "https://github.com/rxreyn3/speak-mcp#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}