@prosodyai/mcp-docs

Servidor MCP que expone la documentación de ProsodyAI, referencias de SDK, referencia de API REST (OpenAPI) y recetas de implementación seleccionadas a agentes de codificación de IA.

Creado para que un agente de codificación externo (p. ej., AureliaStudio) pueda implementar integraciones de ProsodyAI correctamente a la primera, sin necesidad de hacer scraping del sitio web ni adivinar las formas de la API.

Se entrega con dos transportes en una única base de código TypeScript:

• stdio — para agentes locales (Cursor, Claude Code, Cline, etc.)

• HTTP (HTTP transmitible) — para agentes remotos/alojados

Herramientas expuestas

Cada entrada también se expone como un recurso MCP en prosodyai://<section>/<id> para clientes que prefieren recursos sobre herramientas.

Recetas incluidas

• recipes/sdk-typescript-quickstart — Añadir ProsodyAI a una aplicación Node / Next.js / navegador

• recipes/livekit-realtime-agent — Agente de voz en tiempo real con adaptación basada en prosodia

• recipes/langchain-agent — Usar prosody como una herramienta de LangChain

• recipes/browser-streaming — Transmitir audio de micrófono desde el navegador

• recipes/kpi-flow — Definir KPIs personalizados y cerrar el ciclo de retroalimentación

• recipes/rest-api-integration — Integración REST directa sin un SDK

Ejecución local

npm install
npm run build         # syncs content/ from the monorepo, then compiles
npm run start:stdio   # for stdio MCP clients
npm run start:http    # http on localhost:3333/mcp

npm run build:content reconstruye content/ desde el monorepo principal. Localiza el monorepo a través de PROSODYAI_REPO_ROOT o subiendo desde el directorio de este paquete (funciona cuando se monta como packages/mcp-docs en el monorepo principal).

Usarlo desde AureliaStudio (o cualquier cliente MCP)

Stdio (local)

Añadir al mcp.json de su cliente:

{
  "mcpServers": {
    "prosodyai-docs": {
      "command": "npx",
      "args": ["-y", "@prosodyai/mcp-docs"]
    }
  }
}

O ejecutar desde un checkout:

{
  "mcpServers": {
    "prosodyai-docs": {
      "command": "node",
      "args": ["/abs/path/to/mcp-docs/dist/stdio.js"]
    }
  }
}

HTTP (remoto)

Una vez desplegado (ver abajo), apunte su cliente a la URL pública:

{
  "mcpServers": {
    "prosodyai-docs": {
      "url": "https://prosodyai-docs.vercel.app/mcp"
    }
  }
}

Despliegue

El punto de entrada HTTP es una aplicación express simple que escucha en PORT (por defecto 3333) en la ruta /mcp. Funciona en cualquier host de Node:

• Vercel / Cloud Run / Fly / Railway: desplegar como un servicio Node con npm run build como paso de compilación y npm run start:http como comando de inicio.

• Docker: ver Dockerfile (imagen Node 20-slim de una sola etapa).

/healthz devuelve un latido JSON para orquestadores de contenedores.

Actualización de contenido

Siempre que la documentación, los READMEs de SDK o la especificación OpenAPI del monorepo principal cambien:

cd packages/mcp-docs    # or wherever this is mounted
npm run build:content
git add content/ && git commit -m "Sync docs from monorepo"

El siguiente despliegue servirá el nuevo contenido. (La CI en la rama master de ProsodyAI/prosodyai debería ejecutar esto automáticamente — ver .github/workflows/sync.yml si está presente.)

Licencia

MIT