@prosodyai/mcp-docs

MCP 服务器，旨在向 AI 编码代理提供 ProsodyAI 文档、SDK 参考、REST API 参考（OpenAPI）以及精选的实现方案。

构建此项目的目的是让外部编码代理（例如 AureliaStudio）能够一次性正确实现 ProsodyAI 集成，而无需抓取网站或猜测 API 结构。

在单个 TypeScript 代码库中附带了两种传输方式：

• stdio — 适用于本地代理（Cursor、Claude Code、Cline 等）

• HTTP (Streamable HTTP) — 适用于远程/托管代理

公开的工具

对于偏好资源而非工具的客户端，每个条目也作为 MCP 资源在 prosodyai://<section>/<id> 下公开。

附带的方案

• recipes/sdk-typescript-quickstart — 将 ProsodyAI 添加到 Node / Next.js / 浏览器应用

• recipes/livekit-realtime-agent — 具有韵律驱动自适应能力的实时语音代理

• recipes/langchain-agent — 将 Prosody 用作 LangChain 工具

• recipes/browser-streaming — 从浏览器流式传输麦克风音频

• recipes/kpi-flow — 定义自定义 KPI 并闭环反馈

• recipes/rest-api-integration — 无需 SDK 的直接 REST 集成

本地运行

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 会从父级 monorepo 重建 content/。它通过 PROSODYAI_REPO_ROOT 或从当前包目录向上查找来定位 monorepo（当作为 packages/mcp-docs 挂载在父级 monorepo 中时有效）。

从 AureliaStudio（或任何 MCP 客户端）使用

Stdio (本地)

添加到客户端的 mcp.json 中：

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

或者从检出目录运行：

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

HTTP (远程)

部署后（见下文），将客户端指向公共 URL：

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

部署

HTTP 入口点是一个简单的 express 应用，监听 PORT（默认为 3333）的 /mcp 路径。它适用于任何 Node 主机：

• Vercel / Cloud Run / Fly / Railway：部署为 Node 服务，使用 npm run build 作为构建步骤，使用 npm run start:http 作为启动命令。

• Docker：参见 Dockerfile（单阶段 Node 20-slim 镜像）。

/healthz 为容器编排器返回 JSON 心跳。

更新内容

每当父级 monorepo 的文档、SDK README 或 OpenAPI 规范发生更改时：

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

下一次部署将提供新内容。（ProsodyAI/prosodyai 的 master 分支上的 CI 应自动运行此操作 — 如果存在，请参阅 .github/workflows/sync.yml。）

许可证

MIT