@prosodyai/mcp-docs

ProsodyAI 문서, SDK 참조, REST API 참조(OpenAPI) 및 엄선된 구현 레시피를 AI 코딩 에이전트에 제공하는 MCP 서버입니다.

외부 코딩 에이전트(예: AureliaStudio)가 웹사이트를 스크래핑하거나 API 형태를 추측할 필요 없이, 처음부터 올바르게 ProsodyAI 통합을 구현할 수 있도록 구축되었습니다.

단일 TypeScript 코드베이스 내에 두 가지 전송 방식을 제공합니다:

• stdio — 로컬 에이전트용 (Cursor, Claude Code, Cline 등)

• HTTP (Streamable HTTP) — 원격/호스팅 에이전트용

제공되는 도구

모든 항목은 리소스보다 도구를 선호하는 클라이언트를 위해 prosodyai://<section>/<id> 경로의 MCP 리소스로도 제공됩니다.

제공되는 레시피

• recipes/sdk-typescript-quickstart — Node / Next.js / 브라우저 앱에 ProsodyAI 추가

• recipes/livekit-realtime-agent — Prosody 기반 적응형 실시간 음성 에이전트

• recipes/langchain-agent — LangChain 도구로 Prosody 사용

• 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 진입점은 /mcp 경로에서 PORT(기본값 3333)를 수신하는 일반 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