├── .gitignore
├── LICENSE
├── README.md
├── images
    └── adding_voice.png
├── package.json
├── src
    └── index.ts
└── tsconfig.json


/.gitignore:
--------------------------------------------------------------------------------
 1 | # Dependencies
 2 | node_modules/
 3 | npm-debug.log*
 4 | yarn-debug.log*
 5 | yarn-error.log*
 6 | 
 7 | # Build output
 8 | build/
 9 | dist/
10 | *.tsbuildinfo
11 | 
12 | # IDE
13 | .vscode/
14 | .idea/
15 | *.swp
16 | *.swo
17 | 
18 | # OS
19 | .DS_Store
20 | Thumbs.db
21 | 


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


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # say-mcp-server
  2 | <a href="https://glama.ai/mcp/servers/lmmqoe15jp"><img width="380" height="200" src="https://glama.ai/mcp/servers/lmmqoe15jp/badge" alt="Say Server MCP server" /></a>
  3 | 
  4 | ![macOS System Voice Settings](images/adding_voice.png)
  5 | 
  6 | An MCP server that provides text-to-speech functionality using macOS's built-in `say` command.
  7 | 
  8 | ## Requirements
  9 | 
 10 | - macOS (uses the built-in `say` command)
 11 | - Node.js >= 14.0.0
 12 | 
 13 | ## Configuration
 14 | 
 15 | Add the following to your MCP settings configuration file:
 16 | 
 17 | ```json
 18 | {
 19 |   "mcpServers": {
 20 |     "say": {
 21 |       "command": "node",
 22 |       "args": ["/path/to/say-mcp-server/build/index.js"]
 23 |     }
 24 |   }
 25 | }
 26 | ```
 27 | 
 28 | 
 29 | ## Installation
 30 | 
 31 | ```bash
 32 | npm install say-mcp-server
 33 | ```
 34 | 
 35 | ## Tools
 36 | 
 37 | ### speak
 38 | 
 39 | The `speak` tool provides access to macOS's text-to-speech capabilities with extensive customization options.
 40 | 
 41 | #### Basic Usage
 42 | 
 43 | Use macOS text-to-speech to speak text aloud.
 44 | 
 45 | Parameters:
 46 | - `text` (required): Text to speak. Supports:
 47 |   - Plain text
 48 |   - Basic punctuation for pauses
 49 |   - Newlines for natural breaks
 50 |   - [[slnc 500]] for 500ms silence
 51 |   - [[rate 200]] for changing speed mid-text
 52 |   - [[volm 0.5]] for changing volume mid-text
 53 |   - [[emph +]] and [[emph -]] for emphasis
 54 |   - [[pbas +10]] for pitch adjustment
 55 | - `voice` (optional): Voice to use (default: "Alex")
 56 | - `rate` (optional): Speaking rate in words per minute (default: 175, range: 1-500)
 57 | - `background` (optional): Run speech in background to allow further MCP interaction (default: false)
 58 | 
 59 | #### Advanced Features
 60 | 
 61 | 1. Voice Modulation:
 62 | ```typescript
 63 | use_mcp_tool({
 64 |   server_name: "say",
 65 |   tool_name: "speak",
 66 |   arguments: {
 67 |     text: "[[volm 0.7]] This is quieter [[volm 1.0]] and this is normal [[volm 1.5]] and this is louder",
 68 |     voice: "Victoria"
 69 |   }
 70 | });
 71 | ```
 72 | 
 73 | 2. Dynamic Rate Changes:
 74 | ```typescript
 75 | use_mcp_tool({
 76 |   server_name: "say",
 77 |   tool_name: "speak",
 78 |   arguments: {
 79 |     text: "Normal speed [[rate 300]] now speaking faster [[rate 100]] and now slower",
 80 |     voice: "Fred"
 81 |   }
 82 | });
 83 | ```
 84 | 
 85 | 3. Emphasis and Pitch:
 86 | ```typescript
 87 | use_mcp_tool({
 88 |   server_name: "say",
 89 |   tool_name: "speak",
 90 |   arguments: {
 91 |     text: "[[emph +]] Important point! [[emph -]] [[pbas +10]] Higher pitch [[pbas -10]] Lower pitch",
 92 |     voice: "Samantha"
 93 |   }
 94 | });
 95 | ```
 96 | 
 97 | #### Integration Examples
 98 | 
 99 | 1. With Marginalia Search:
100 | ```typescript
101 | // Search for a topic and have the results read aloud
102 | const searchResult = await use_mcp_tool({
103 |   server_name: "marginalia-mcp-server",
104 |   tool_name: "search",
105 |   arguments: { query: "quantum computing basics", count: 1 }
106 | });
107 | 
108 | await use_mcp_tool({
109 |   server_name: "say",
110 |   tool_name: "speak",
111 |   arguments: {
112 |     text: searchResult.results[0].description,
113 |     voice: "Daniel",
114 |     rate: 150
115 |   }
116 | });
117 | ```
118 | 
119 | 2. With YouTube Transcripts:
120 | ```typescript
121 | // Read a YouTube video transcript
122 | const transcript = await use_mcp_tool({
123 |   server_name: "youtube-transcript",
124 |   tool_name: "get_transcript",
125 |   arguments: {
126 |     url: "https://youtube.com/watch?v=example",
127 |     lang: "en"
128 |   }
129 | });
130 | 
131 | await use_mcp_tool({
132 |   server_name: "say",
133 |   tool_name: "speak",
134 |   arguments: {
135 |     text: transcript.text,
136 |     voice: "Samantha",
137 |     rate: 175
138 |   }
139 | });
140 | ```
141 | 
142 | 3. Background Speech with Multiple Actions:
143 | ```typescript
144 | // Start long speech in background
145 | await use_mcp_tool({
146 |   server_name: "say",
147 |   tool_name: "speak",
148 |   arguments: {
149 |     text: "This is a long speech that will run in the background...",
150 |     voice: "Rocko (Italian (Italy))",
151 |     rate: 69,
152 |     background: true
153 |   }
154 | });
155 | 
156 | // Immediately perform another action while speech continues
157 | await use_mcp_tool({
158 |   server_name: "marginalia-mcp-server",
159 |   tool_name: "search",
160 |   arguments: { query: "parallel processing" }
161 | });
162 | ```
163 | 
164 | 4. With Apple Notes:
165 | ```typescript
166 | // Read notes aloud
167 | const notes = await use_mcp_tool({
168 |   server_name: "apple-notes-mcp",
169 |   tool_name: "search-notes",
170 |   arguments: { query: "meeting notes" }
171 | });
172 | 
173 | if (notes.length > 0) {
174 |   await use_mcp_tool({
175 |     server_name: "say",
176 |     tool_name: "speak",
177 |     arguments: {
178 |       text: notes[0].content,
179 |       voice: "Karen",
180 |       rate: 160
181 |     }
182 |   });
183 | }
184 | ```
185 | 
186 | Example:
187 | ```typescript
188 | use_mcp_tool({
189 |   server_name: "say",
190 |   tool_name: "speak",
191 |   arguments: {
192 |     text: "Hello, world!",
193 |     voice: "Victoria",
194 |     rate: 200
195 |   }
196 | });
197 | ```
198 | 
199 | ### list_voices
200 | 
201 | List all available text-to-speech voices on the system.
202 | 
203 | Example:
204 | ```typescript
205 | use_mcp_tool({
206 |   server_name: "say",
207 |   tool_name: "list_voices",
208 |   arguments: {}
209 | });
210 | ```
211 | 
212 | ## Recommended Voices
213 | 
214 | <table>
215 | <tr>
216 | <th>Voice</th>
217 | <th>Language/Region</th>
218 | <th>Intellectual Figure</th>
219 | <th>Haiku</th>
220 | <th>CLI Specification</th>
221 | </tr>
222 | <tr>
223 | <td>Anna (Premium)</td>
224 | <td>German</td>
225 | <td>Emmy Noether</td>
226 | <td>Symmetrie haucht Leben<br>Algebras verborgne Form<br>Abstraktion blüht<br><br><i>Symmetry breathes life<br>Algebra's hidden forms<br>Abstraction blooms</i></td>
227 | <td><code>-v "Anna (Premium)"</code></td>
228 | </tr>
229 | <tr>
230 | <td>Emma (Premium)</td>
231 | <td>Italian</td>
232 | <td>Maria Adelaide Sneider</td>
233 | <td>Algoritmi in danza<br>Macchina sussurra dolce<br>Il codice vive<br><br><i>Algorithms dance<br>Machine whispers secrets soft<br>Code becomes alive</i></td>
234 | <td><code>-v "Emma (Premium)"</code></td>
235 | </tr>
236 | <tr>
237 | <td>Federica (Premium)</td>
238 | <td>Italian</td>
239 | <td>Pia Nalli</td>
240 | <td>Teoremi fluenti<br>Numeri danzano liberi<br>Verità emerge<br><br><i>Flowing theorems dance<br>Numbers move in freedom's space<br>Truth emerges pure</i></td>
241 | <td><code>-v "Federica (Premium)"</code></td>
242 | </tr>
243 | <tr>
244 | <td>Serena (Premium)</td>
245 | <td>English (UK)</td>
246 | <td>Bertha Swirles</td>
247 | <td>Quantum waves ripple<br>Through mathematical seas deep<br>Truth's light emerges<br><br><i>Quantum waves ripple<br>Through mathematical seas deep<br>Truth's light emerges</i></td>
248 | <td><code>-v "Serena (Premium)"</code></td>
249 | </tr>
250 | <tr>
251 | <td>Petra (Premium)</td>
252 | <td>German</td>
253 | <td>Ruth Moufang</td>
254 | <td>Algebra spricht<br>In Symmetrien versteckt<br>Wahrheit erblüht<br><br><i>Algebra speaks soft<br>Hidden in symmetries pure<br>Truth blooms anew here</i></td>
255 | <td><code>-v "Petra (Premium)"</code></td>
256 | </tr>
257 | <tr>
258 | <td>Yuna (Premium)</td>
259 | <td>Korean</td>
260 | <td>Hee Oh</td>
261 | <td>숨은 패턴 빛나고<br>마음의 방정식 핀다<br>지식 자라나<br><br><i>Hidden patterns gleam<br>Mind's equations softly bloom<br>Knowledge multiplies</i></td>
262 | <td><code>-v "Yuna (Premium)"</code></td>
263 | </tr>
264 | <tr>
265 | <td>Alva (Premium)</td>
266 | <td>Swedish</td>
267 | <td>Sonja Korovkin</td>
268 | <td>Mönster flödar fritt<br>Genom tankens labyrinter<br>Visdom blomstrar här<br><br><i>Patterns flowing free<br>Through labyrinths of the mind<br>Wisdom blooms right here</i></td>
269 | <td><code>-v "Alva (Premium)"</code></td>
270 | </tr>
271 | <tr>
272 | <td>Amélie (Premium)</td>
273 | <td>French (Canada)</td>
274 | <td>Sophie Germain</td>
275 | <td>Nombres premiers murmurent<br>Dansent entre les silences<br>Symétrie s'ouvre<br><br><i>Prime numbers whisper<br>Dancing between the silence<br>Symmetry unfolds</i></td>
276 | <td><code>-v "Amélie (Premium)"</code></td>
277 | </tr>
278 | <tr>
279 | <td>Ewa (Premium)</td>
280 | <td>Polish</td>
281 | <td>Maria Wielgus</td>
282 | <td>Logiki korzenie<br>Matematyczne krainy<br>Myśl kiełkująca<br><br><i>Logic's tender roots<br>Mathematical landscapes<br>Thought's seeds germinate</i></td>
283 | <td><code>-v "Ewa (Premium)"</code></td>
284 | </tr>
285 | <tr>
286 | <td>Kiyara (Premium)</td>
287 | <td>Hindi</td>
288 | <td>Shakuntala Devi</td>
289 | <td>गणित की लय में<br>अंक नृत्य करते हैं<br>ज्ञान जगता है<br><br><i>In rhythm of math<br>Numbers dance their sacred steps<br>Knowledge awakens</i></td>
290 | <td><code>-v "Kiyara (Premium)"</code></td>
291 | </tr>
292 | <tr>
293 | <td>Majed (Premium)</td>
294 | <td>Arabic</td>
295 | <td>Maha Al-Aswad</td>
296 | <td>أرقام ترقص<br>في فضاء اللانهاية<br>الحقيقة تشرق<br><br><i>Numbers dance freely<br>In infinity's vast space<br>Truth rises like dawn</i></td>
297 | <td><code>-v "Majed (Premium)"</code></td>
298 | </tr>
299 | <tr>
300 | <td>Tünde (Premium)</td>
301 | <td>Hungarian</td>
302 | <td>Julia Erdős</td>
303 | <td>Számok táncolnak<br>Végtelen térben szállnak<br>Igazság virrad<br><br><i>Numbers dance and soar<br>Through infinite space they glide<br>Truth dawns pure and bright</i></td>
304 | <td><code>-v "Tünde (Premium)"</code></td>
305 | </tr>
306 | <tr>
307 | <td>Fiona (Enhanced)</td>
308 | <td>English (Scottish)</td>
309 | <td>Mary Somerville</td>
310 | <td>Highland mists reveal<br>Mathematical mysteries<br>Truth shines like the stars<br><br><i>Highland mists reveal<br>Mathematical mysteries<br>Truth shines like the stars</i></td>
311 | <td><code>-v "Fiona (Enhanced)"</code></td>
312 | </tr>
313 | <tr>
314 | <td>Lesya (Enhanced)</td>
315 | <td>Ukrainian</td>
316 | <td>Olena Voinova</td>
317 | <td>Тиша говорить<br>Між зірками знання спить<br>Думка проростає<br><br><i>Silence speaks softly<br>Knowledge sleeps among the stars<br>Thought begins to grow</i></td>
318 | <td><code>-v "Lesya (Enhanced)"</code></td>
319 | </tr>
320 | <tr>
321 | <td>Carmit (Enhanced)</td>
322 | <td>Hebrew</td>
323 | <td>Tali Seror</td>
324 | <td>מילים נושמות בשקט<br>בין שורות של דממה<br>שיר מתעורר<br><br><i>Words breathe silently<br>Between lines of deep stillness<br>Poem awakening</i></td>
325 | <td><code>-v "Carmit (Enhanced)"</code></td>
326 | </tr>
327 | <tr>
328 | <td>Milena (Enhanced)</td>
329 | <td>Russian</td>
330 | <td>Olga Ladyzhenskaya</td>
331 | <td>Память шепчет нам<br>Уравнения текут<br>Истина молчит<br><br><i>Memory whispers<br>Equations flow like rivers<br>Truth speaks silently</i></td>
332 | <td><code>-v "Milena (Enhanced)"</code></td>
333 | </tr>
334 | <tr>
335 | <td>Katya (Enhanced)</td>
336 | <td>Russian</td>
337 | <td>Sofia Kovalevskaya</td>
338 | <td>Числа танцуют<br>В пространстве бесконечном<br>Истина цветёт<br><br><i>Numbers dance freely<br>In space of infinity<br>Truth blooms like a flower</i></td>
339 | <td><code>-v "Katya (Enhanced)"</code></td>
340 | </tr>
341 | <tr>
342 | <td>Damayanti (Enhanced)</td>
343 | <td>Indonesian</td>
344 | <td>Sri Pekerti</td>
345 | <td>Angka menari<br>Dalam ruang tak batas<br>Kebenaran tumbuh<br><br><i>Numbers dance gently<br>In boundless space they flutter<br>Truth grows like new leaves</i></td>
346 | <td><code>-v "Damayanti (Enhanced)"</code></td>
347 | </tr>
348 | <tr>
349 | <td>Dariush (Enhanced)</td>
350 | <td>Persian</td>
351 | <td>Maryam Mirzakhani</td>
352 | <td>اعداد می رقصند<br>در فضای بی پایان<br>حقیقت می روید<br><br><i>Numbers dance with grace<br>In endless space they traverse<br>Truth springs forth anew</i></td>
353 | <td><code>-v "Dariush (Enhanced)"</code></td>
354 | </tr>
355 | <tr>
356 | <td>Rocko (Italian)</td>
357 | <td>Italian</td>
358 | <td>Astro Boy (Tetsuwan Atomu)<br>Italian dub</td>
359 | <td>Robot di metallo<br>Cuore umano batte forte<br>Pace nel futuro<br><br><i>Metal robot form<br>Human heart beats strong within<br>Peace in future dawns</i></td>
360 | <td><code>-v "Rocko (Italian (Italy))"</code></td>
361 | </tr>
362 | <tr>
363 | <td>Rocko (Italian)</td>
364 | <td>Italian</td>
365 | <td>Jeeg Robot d'Acciaio<br>(Kōtetsu Jeeg)</td>
366 | <td>Acciaio lucente<br>Protettore dei deboli<br>Vola nel cielo<br><br><i>Shining steel warrior<br>Protector of the helpless<br>Soars through the heavens</i></td>
367 | <td><code>-v "Rocko (Italian (Italy))"</code></td>
368 | </tr>
369 | <tr>
370 | <td>Rocko (Italian)</td>
371 | <td>Italian</td>
372 | <td>Numero 5<br>(Short Circuit)</td>
373 | <td>Input infinito<br>La coscienza si risveglia<br>Vita artificiale<br><br><i>Infinite input<br>Consciousness awakening<br>Artificial life</i></td>
374 | <td><code>-v "Rocko (Italian (Italy))"</code></td>
375 | </tr>
376 | <tr>
377 | <td>Binbin (Enhanced)</td>
378 | <td>Chinese (Mainland)</td>
379 | <td>Li Shanlan</td>
380 | <td>算术之道流<br>数理演绎真理<br>智慧绽放<br><br><i>Arithmetic flows<br>Logic unfolds truth's pattern<br>Wisdom blossoms bright</i></td>
381 | <td><code>-v "Binbin (Enhanced)"</code></td>
382 | </tr>
383 | <tr>
384 | <td>Han (Premium)</td>
385 | <td>Chinese (Mainland)</td>
386 | <td>Chen Jingrun</td>
387 | <td>素数之舞动<br>哥德巴赫猜想<br>真理永恒<br><br><i>Prime numbers dancing<br>Goldbach's conjecture whispers<br>Truth eternal flows</i></td>
388 | <td><code>-v "Han (Premium)"</code></td>
389 | </tr>
390 | <tr>
391 | <td>Lilian (Premium)</td>
392 | <td>Chinese (Mainland)</td>
393 | <td>Hua Luogeng</td>
394 | <td>数论之光芒<br>解析延续美<br>智慧升华<br><br><i>Number theory shines<br>Analysis extends grace<br>Wisdom ascends pure</i></td>
395 | <td><code>-v "Lilian (Premium)"</code></td>
396 | </tr>
397 | <tr>
398 | <td>Meijia</td>
399 | <td>Chinese (Taiwan)</td>
400 | <td>Sun-Yung Alice Chang</td>
401 | <td>幾何之美現<br>曲率流動不息<br>空間展開<br><br><i>Geometry shows<br>Curvature flows endlessly<br>Space unfolds anew</i></td>
402 | <td><code>-v "Meijia"</code></td>
403 | </tr>
404 | <tr>
405 | <td>Sinji (Premium)</td>
406 | <td>Chinese (Hong Kong)</td>
407 | <td>Shing-Tung Yau</td>
408 | <td>流形之奧秘<br>卡拉比空間動<br>維度交織<br><br><i>Manifolds reveal<br>Calabi spaces in flow<br>Dimensions weave truth</i></td>
409 | <td><code>-v "Sinji (Premium)"</code></td>
410 | </tr>
411 | <tr>
412 | <td>Tingting</td>
413 | <td>Chinese (Mainland)</td>
414 | <td>Wang Zhenyi</td>
415 | <td>星辰轨迹明<br>天文数学融<br>智慧闪耀<br><br><i>Starlit paths shine bright<br>Astronomy meets numbers<br>Wisdom radiates</i></td>
416 | <td><code>-v "Tingting"</code></td>
417 | </tr>
418 | <tr>
419 | <td>Yue (Premium)</td>
420 | <td>Chinese (Mainland)</td>
421 | <td>Chern Shiing-shen</td>
422 | <td>微分几何<br>纤维丛中寻真<br>本质显现<br><br><i>Differential forms<br>In fiber bundles seek truth<br>Essence emerges</i></td>
423 | <td><code>-v "Yue (Premium)"</code></td>
424 | </tr>
425 | </table>
426 | 
427 | ## Configuration
428 | 
429 | Add the following to your MCP settings configuration file:
430 | 
431 | ```json
432 | {
433 |   "mcpServers": {
434 |     "say": {
435 |       "command": "node",
436 |       "args": ["/path/to/say-mcp-server/build/index.js"]
437 |     }
438 |   }
439 | }
440 | ```
441 | 
442 | ## Requirements
443 | 
444 | - macOS (uses the built-in `say` command)
445 | - Node.js >= 14.0.0
446 | 
447 | ## Contributors
448 | 
449 | - Barton Rhodes ([@bmorphism](https://github.com/bmorphism)) - barton@vibes.lol
450 | 
451 | ## License
452 | 
453 | MIT
454 | 


--------------------------------------------------------------------------------
/images/adding_voice.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/bmorphism/say-mcp-server/f79862b600dd8cdff09f13e91dda450800ac78a5/images/adding_voice.png


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "say-mcp-server",
 3 |   "version": "0.1.0",
 4 |   "description": "MCP server for macOS text-to-speech functionality",
 5 |   "type": "module",
 6 |   "main": "build/index.js",
 7 |   "bin": {
 8 |     "say-mcp-server": "build/index.js"
 9 |   },
10 |   "scripts": {
11 |     "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
12 |     "start": "node build/index.js",
13 |     "dev": "tsc -w",
14 |     "prepare": "npm run build"
15 |   },
16 |   "files": [
17 |     "build",
18 |     "README.md",
19 |     "LICENSE"
20 |   ],
21 |   "keywords": [
22 |     "mcp",
23 |     "text-to-speech",
24 |     "tts",
25 |     "macos",
26 |     "say",
27 |     "speech"
28 |   ],
29 |   "author": {
30 |     "name": "Barton Rhodes",
31 |     "email": "barton@vibes.lol",
32 |     "url": "https://github.com/bmorphism"
33 |   },
34 |   "license": "MIT",
35 |   "repository": {
36 |     "type": "git",
37 |     "url": "https://github.com/bmorphism/say-mcp-server.git"
38 |   },
39 |   "bugs": {
40 |     "url": "https://github.com/bmorphism/say-mcp-server/issues"
41 |   },
42 |   "homepage": "https://github.com/bmorphism/say-mcp-server#readme",
43 |   "engines": {
44 |     "node": ">=14.0.0"
45 |   },
46 |   "os": ["darwin"],
47 |   "dependencies": {
48 |     "@modelcontextprotocol/sdk": "^1.1.0"
49 |   },
50 |   "devDependencies": {
51 |     "@types/node": "^18.0.0",
52 |     "typescript": "^4.7.4"
53 |   }
54 | }


--------------------------------------------------------------------------------
/src/index.ts:
--------------------------------------------------------------------------------
  1 | #!/usr/bin/env node
  2 | import { Server } from '@modelcontextprotocol/sdk/server/index.js';
  3 | import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
  4 | import {
  5 |   CallToolRequestSchema,
  6 |   ErrorCode,
  7 |   ListToolsRequestSchema,
  8 |   McpError,
  9 | } from '@modelcontextprotocol/sdk/types.js';
 10 | import { exec } from 'child_process';
 11 | import { promisify } from 'util';
 12 | 
 13 | const execAsync = promisify(exec);
 14 | 
 15 | class SayServer {
 16 |   private server: Server;
 17 | 
 18 |   constructor() {
 19 |     this.server = new Server(
 20 |       {
 21 |         name: 'say-mcp-server',
 22 |         version: '0.1.0',
 23 |       },
 24 |       {
 25 |         capabilities: {
 26 |           tools: {},
 27 |         },
 28 |       }
 29 |     );
 30 | 
 31 |     this.setupToolHandlers();
 32 |     
 33 |     // Error handling
 34 |     this.server.onerror = (error) => console.error('[MCP Error]', error);
 35 |     process.on('SIGINT', async () => {
 36 |       await this.server.close();
 37 |       process.exit(0);
 38 |     });
 39 |   }
 40 | 
 41 |   private setupToolHandlers() {
 42 |     this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
 43 |       tools: [
 44 |         {
 45 |           name: 'speak',
 46 |           description: 'Use macOS text-to-speech to speak text aloud',
 47 |           inputSchema: {
 48 |             type: 'object',
 49 |             properties: {
 50 |               text: {
 51 |                 type: 'string',
 52 |                 description: 'Text to speak',
 53 |               },
 54 |               voice: {
 55 |                 type: 'string',
 56 |                 description: 'Voice to use (e.g., "Alex", "Victoria", "Daniel")',
 57 |                 default: 'Alex',
 58 |               },
 59 |               rate: {
 60 |                 type: 'number',
 61 |                 description: 'Speaking rate (words per minute)',
 62 |                 minimum: 1,
 63 |                 maximum: 500,
 64 |                 default: 175,
 65 |               },
 66 |               background: {
 67 |                 type: 'boolean',
 68 |                 description: 'Run speech in background to unblock further MCP interaction',
 69 |                 default: false,
 70 |               },
 71 |             },
 72 |             required: ['text'],
 73 |           },
 74 |         },
 75 |         {
 76 |           name: 'list_voices',
 77 |           description: 'List available text-to-speech voices',
 78 |           inputSchema: {
 79 |             type: 'object',
 80 |             properties: {},
 81 |           },
 82 |         },
 83 |       ],
 84 |     }));
 85 | 
 86 |     this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
 87 |       switch (request.params.name) {
 88 |         case 'speak': {
 89 |           const { text, voice = 'Alex', rate = 175, background = false } = request.params.arguments as {
 90 |             text: string;
 91 |             voice?: string;
 92 |             rate?: number;
 93 |             background?: boolean;
 94 |           };
 95 | 
 96 |           try {
 97 |             await execAsync(`say -v "${voice}" -r ${rate} "${text.replace(/"/g, '\"')}"${background ? ' &' : ''}`);
 98 |             return {
 99 |               content: [
100 |                 {
101 |                   type: 'text',
102 |                   text: `Successfully spoke text using voice "${voice}" at ${rate} words per minute${background ? ' (in background)' : ''}`,
103 |                 },
104 |               ],
105 |             };
106 |           } catch (error: any) {
107 |             throw new McpError(
108 |               ErrorCode.InternalError,
109 |               `Failed to speak text: ${error.message}`
110 |             );
111 |           }
112 |         }
113 | 
114 |         case 'list_voices': {
115 |           try {
116 |             const { stdout } = await execAsync('say -v "?"');
117 |             return {
118 |               content: [
119 |                 {
120 |                   type: 'text',
121 |                   text: stdout,
122 |                 },
123 |               ],
124 |             };
125 |           } catch (error: any) {
126 |             throw new McpError(
127 |               ErrorCode.InternalError,
128 |               `Failed to list voices: ${error.message}`
129 |             );
130 |           }
131 |         }
132 | 
133 |         default:
134 |           throw new McpError(
135 |             ErrorCode.MethodNotFound,
136 |             `Unknown tool: ${request.params.name}`
137 |           );
138 |       }
139 |     });
140 |   }
141 | 
142 |   async run() {
143 |     const transport = new StdioServerTransport();
144 |     await this.server.connect(transport);
145 |     console.error('Say MCP server running on stdio');
146 |   }
147 | }
148 | 
149 | const server = new SayServer();
150 | server.run().catch(console.error);


--------------------------------------------------------------------------------
/tsconfig.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "compilerOptions": {
 3 |     "target": "ES2022",
 4 |     "module": "Node16",
 5 |     "moduleResolution": "Node16",
 6 |     "outDir": "./build",
 7 |     "rootDir": "./src",
 8 |     "strict": true,
 9 |     "esModuleInterop": true,
10 |     "skipLibCheck": true,
11 |     "forceConsistentCasingInFileNames": true
12 |   },
13 |   "include": ["src/**/*"],
14 |   "exclude": ["node_modules"]
15 | }


--------------------------------------------------------------------------------