Say MCP Server

A text-to-speech server using the macOS `say` command.

Documentação

say-mcp-server

Say Server MCP server

macOS System Voice Settings

Um servidor MCP que fornece funcionalidade de texto-para-fala usando o comando say integrado do macOS.

Requisitos

  • macOS (usa o comando say integrado)
  • Node.js >= 14.0.0

Configuração

Adicione o seguinte ao seu arquivo de configuração de configurações MCP:

{
  "mcpServers": {
    "say": {
      "command": "node",
      "args": ["/path/to/say-mcp-server/build/index.js"]
    }
  }
}

Instalação

npm install say-mcp-server

Ferramentas

speak

A ferramenta speak fornece acesso aos recursos de texto-para-fala do macOS com opções extensas de personalização.

Uso Básico

Use o texto-para-fala do macOS para falar texto em voz alta.

Parâmetros:

  • text (obrigatório): Texto a ser falado. Suporta:
    • Texto simples
    • Pontuação básica para pausas
    • Novas linhas para quebras naturais
    • [[slnc 500]] para 500ms de silêncio
    • [[rate 200]] para alterar a velocidade no meio do texto
    • [[volm 0.5]] para alterar o volume no meio do texto
    • [[emph +]] e [[emph -]] para ênfase
    • [[pbas +10]] para ajuste de tom
  • voice (opcional): Voz a ser usada (padrão: "Alex")
  • rate (opcional): Taxa de fala em palavras por minuto (padrão: 175, intervalo: 1-500)
  • background (opcional): Executar a fala em segundo plano para permitir interação adicional com MCP (padrão: false)

Recursos Avançados

  1. Modulação de Voz:
use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "[[volm 0.7]] This is quieter [[volm 1.0]] and this is normal [[volm 1.5]] and this is louder",
    voice: "Victoria"
  }
});
  1. Alterações Dinâmicas de Taxa:
use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "Normal speed [[rate 300]] now speaking faster [[rate 100]] and now slower",
    voice: "Fred"
  }
});
  1. Ênfase e Tom:
use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "[[emph +]] Important point! [[emph -]] [[pbas +10]] Higher pitch [[pbas -10]] Lower pitch",
    voice: "Samantha"
  }
});

Exemplos de Integração

  1. Com Marginalia Search:
// Search for a topic and have the results read aloud
const searchResult = await use_mcp_tool({
  server_name: "marginalia-mcp-server",
  tool_name: "search",
  arguments: { query: "quantum computing basics", count: 1 }
});

await use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: searchResult.results[0].description,
    voice: "Daniel",
    rate: 150
  }
});
  1. Com Transcrições do YouTube:
// Read a YouTube video transcript
const transcript = await use_mcp_tool({
  server_name: "youtube-transcript",
  tool_name: "get_transcript",
  arguments: {
    url: "https://youtube.com/watch?v=example",
    lang: "en"
  }
});

await use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: transcript.text,
    voice: "Samantha",
    rate: 175
  }
});
  1. Fala em Segundo Plano com Múltiplas Ações:
// Start long speech in background
await use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "This is a long speech that will run in the background...",
    voice: "Rocko (Italian (Italy))",
    rate: 69,
    background: true
  }
});

// Immediately perform another action while speech continues
await use_mcp_tool({
  server_name: "marginalia-mcp-server",
  tool_name: "search",
  arguments: { query: "parallel processing" }
});
  1. Com Apple Notes:
// Read notes aloud
const notes = await use_mcp_tool({
  server_name: "apple-notes-mcp",
  tool_name: "search-notes",
  arguments: { query: "meeting notes" }
});

if (notes.length > 0) {
  await use_mcp_tool({
    server_name: "say",
    tool_name: "speak",
    arguments: {
      text: notes[0].content,
      voice: "Karen",
      rate: 160
    }
  });
}

Exemplo:

use_mcp_tool({
  server_name: "say",
  tool_name: "speak",
  arguments: {
    text: "Hello, world!",
    voice: "Victoria",
    rate: 200
  }
});

list_voices

Lista todas as vozes de texto-para-fala disponíveis no sistema.

Exemplo:

use_mcp_tool({
  server_name: "say",
  tool_name: "list_voices",
  arguments: {}
});

Vozes Recomendadas

VozIdioma/RegiãoFigura IntelectualHaicaiEspecificação CLI
Anna (Premium)AlemãoEmmy NoetherSymmetrie haucht Leben
Algebras verborgne Form
Abstraktion blüht

Symmetry breathes life
Algebra's hidden forms
Abstraction blooms
-v "Anna (Premium)"
Emma (Premium)ItalianoMaria Adelaide SneiderAlgoritmi in danza
Macchina sussurra dolce
Il codice vive

Algorithms dance
Machine whispers secrets soft
Code becomes alive
-v "Emma (Premium)"
Federica (Premium)ItalianoPia NalliTeoremi fluenti
Numeri danzano liberi
Verità emerge

Flowing theorems dance
Numbers move in freedom's space
Truth emerges pure
-v "Federica (Premium)"
Serena (Premium)Inglês (Reino Unido)Bertha SwirlesQuantum waves ripple
Through mathematical seas deep
Truth's light emerges

Quantum waves ripple
Through mathematical seas deep
Truth's light emerges
-v "Serena (Premium)"
Petra (Premium)AlemãoRuth MoufangAlgebra spricht
In Symmetrien versteckt
Wahrheit erblüht

Algebra speaks soft
Hidden in symmetries pure
Truth blooms anew here
-v "Petra (Premium)"
Yuna (Premium)CoreanoHee Oh숨은 패턴 빛나고
마음의 방정식 핀다
지식 자라나

Hidden patterns gleam
Mind's equations softly bloom
Knowledge multiplies
-v "Yuna (Premium)"
Alva (Premium)SuecoSonja KorovkinMönster flödar fritt
Genom tankens labyrinter
Visdom blomstrar här

Patterns flowing free
Through labyrinths of the mind
Wisdom blooms right here
-v "Alva (Premium)"
Amélie (Premium)Francês (Canadá)Sophie GermainNombres premiers murmurent
Dansent entre les silences
Symétrie s'ouvre

Prime numbers whisper
Dancing between the silence
Symmetry unfolds
-v "Amélie (Premium)"
Ewa (Premium)PolonêsMaria WielgusLogiki korzenie
Matematyczne krainy
Myśl kiełkująca

Logic's tender roots
Mathematical landscapes
Thought's seeds germinate
-v "Ewa (Premium)"
Kiyara (Premium)HindiShakuntala Deviगणित की लय में
अंक नृत्य करते हैं
ज्ञान जगता है

In rhythm of math
Numbers dance their sacred steps
Knowledge awakens
-v "Kiyara (Premium)"
Majed (Premium)ÁrabeMaha Al-Aswadأرقام ترقص
في فضاء اللانهاية
الحقيقة تشرق

Numbers dance freely
In infinity's vast space
Truth rises like dawn
-v "Majed (Premium)"
Tünde (Premium)HúngaroJulia ErdősSzámok táncolnak
Végtelen térben szállnak
Igazság virrad

Numbers dance and soar
Through infinite space they glide
Truth dawns pure and bright
-v "Tünde (Premium)"
Fiona (Enhanced)Inglês (Escocês)Mary SomervilleHighland mists reveal
Mathematical mysteries
Truth shines like the stars

Highland mists reveal
Mathematical mysteries
Truth shines like the stars
-v "Fiona (Enhanced)"
Lesya (Enhanced)UcranianoOlena VoinovaТиша говорить
Між зірками знання спить
Думка проростає

Silence speaks softly
Knowledge sleeps among the stars
Thought begins to grow
-v "Lesya (Enhanced)"
Carmit (Enhanced)HebraicoTali Serorמילים נושמות בשקט
בין שורות של דממה
שיר מתעורר

Words breathe silently
Between lines of deep stillness
Poem awakening
-v "Carmit (Enhanced)"
Milena (Enhanced)RussoOlga LadyzhenskayaПамять шепчет нам
Уравнения текут
Истина молчит

Memory whispers
Equations flow like rivers
Truth speaks silently
-v "Milena (Enhanced)"
Katya (Enhanced)RussoSofia KovalevskayaЧисла танцуют
В пространстве бесконечном
Истина цветёт

Numbers dance freely
In space of infinity
Truth blooms like a flower
-v "Katya (Enhanced)"
Damayanti (Enhanced)IndonésioSri PekertiAngka menari
Dalam ruang tak batas
Kebenaran tumbuh

Numbers dance gently
In boundless space they flutter
Truth grows like new leaves
-v "Damayanti (Enhanced)"
Dariush (Enhanced)PersaMaryam Mirzakhaniاعداد می رقصند
در فضای بی پایان
حقیقت می روید

Numbers dance with grace
In endless space they traverse
Truth springs forth anew
-v "Dariush (Enhanced)"
Rocko (Italiano)ItalianoAstro Boy (Tetsuwan Atomu)
Dublagem italiana
Robot di metallo
Cuore umano batte forte
Pace nel futuro

Metal robot form
Human heart beats strong within
Peace in future dawns
-v "Rocko (Italian (Italy))"
Rocko (Italiano)ItalianoJeeg Robot d'Acciaio
(Kōtetsu Jeeg)
Acciaio lucente
Protettore dei deboli
Vola nel cielo

Shining steel warrior
Protector of the helpless
Soars through the heavens
-v "Rocko (Italian (Italy))"
Rocko (italiano)ItalianoNúmero 5
(Short Circuit)
Entrada infinita
A consciência desperta
Vida artificial

Infinite input
Consciousness awakening
Artificial life
-v "Rocko (Italian (Italy))"
Binbin (Aprimorado)Chinês (Continental)Li Shanlan算术之道流
数理演绎真理
智慧绽放

Arithmetic flows
Logic unfolds truth's pattern
Wisdom blossoms bright
-v "Binbin (Enhanced)"
Han (Premium)Chinês (Continental)Chen Jingrun素数之舞动
哥德巴赫猜想
真理永恒

Prime numbers dancing
Goldbach's conjecture whispers
Truth eternal flows
-v "Han (Premium)"
Lilian (Premium)Chinês (Continental)Hua Luogeng数论之光芒
解析延续美
智慧升华

Number theory shines
Analysis extends grace
Wisdom ascends pure
-v "Lilian (Premium)"
MeijiaChinês (Taiwan)Sun-Yung Alice Chang幾何之美現
曲率流動不息
空間展開

Geometry shows
Curvature flows endlessly
Space unfolds anew
-v "Meijia"
Sinji (Premium)Chinês (Hong Kong)Shing-Tung Yau流形之奧秘
卡拉比空間動
維度交織

Manifolds reveal
Calabi spaces in flow
Dimensions weave truth
-v "Sinji (Premium)"
TingtingChinês (Continental)Wang Zhenyi星辰轨迹明
天文数学融
智慧闪耀

Starlit paths shine bright
Astronomy meets numbers
Wisdom radiates
-v "Tingting"
Yue (Premium)Chinês (Continental)Chern Shiing-shen微分几何
纤维丛中寻真
本质显现

Differential forms
In fiber bundles seek truth
Essence emerges
-v "Yue (Premium)"
## Configuração

Adicione o seguinte ao seu arquivo de configuração de configurações do MCP:

{
  "mcpServers": {
    "say": {
      "command": "node",
      "args": ["/path/to/say-mcp-server/build/index.js"]
    }
  }
}

Requisitos

  • macOS (usa o comando say integrado)
  • Node.js >= 14.0.0

Contribuidores

Licença

MIT