@prosodyai/mcp-docs

ProsodyAIのドキュメント、SDKリファレンス、REST APIリファレンス（OpenAPI）、および厳選された実装レシピをAIコーディングエージェントに提供するMCPサーバーです。

外部のコーディングエージェント（例：AureliaStudio）が、ウェブサイトをスクレイピングしたりAPIの形状を推測したりすることなく、初回から正確にProsodyAIの統合を実装できるように構築されています。

単一のTypeScriptコードベースで2つのトランスポートを提供します：

• stdio — ローカルエージェント用（Cursor、Claude Code、Clineなど）

• HTTP (Streamable HTTP) — リモート/ホスト型エージェント用

提供されるツール

すべてのエントリは、ツールよりもリソースを好むクライアントのために、prosodyai://<section>/<id> というMCPリソースとしても公開されています。

提供されるレシピ

• recipes/sdk-typescript-quickstart — Node / Next.js / ブラウザアプリにProsodyAIを追加する

• 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 は、親モノレポから content/ を再構築します。これは PROSODYAI_REPO_ROOT を介して、またはこのパッケージのディレクトリから上位階層を探索することでモノレポの場所を特定します（親モノレポ内で packages/mcp-docs としてマウントされている場合に機能します）。

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エントリーポイントは、PORT（デフォルト 3333）の /mcp パスでリッスンする単純な express アプリです。あらゆるNodeホストで動作します：

• Vercel / Cloud Run / Fly / Railway: ビルドステップとして npm run build、開始コマンドとして npm run start:http を使用してNodeサービスとしてデプロイします。

• Docker: Dockerfile を参照してください（シングルステージのNode 20-slimイメージ）。

/healthz は、コンテナオーケストレーター用にJSON形式のハートビートを返します。

コンテンツの更新

親モノレポのドキュメント、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