Repository avatar
Other Tools
v1.0.0
active

dungchua

app.dungchua/dungchua

Vietnamese tone pitch-contour guides and acoustic recording gate checks via Remote MCP.

Documentation

Đúng Chưa? Remote MCP Server (app.dungchua/dungchua)

Hosted Streamable HTTP Model Context Protocol (MCP) server for Vietnamese tone pitch-contour guides, acoustic DSP recording gate evaluation, and factual product discovery on Đúng Chưa?.

  • Remote MCP Endpoint: https://dungchua.app/api/mcp
  • Transport: streamable-http (JSON-RPC 2.0 over HTTPS — no local runtime or installation required)
  • Registry ID: app.dungchua/dungchua (v1.0.0)
  • Authentication: None required (public, read-only, mutations: false)
  • Publisher: Dung Chua Operations (support@dungchua.app)
  • Documentation: https://dungchua.app/mcp · https://dungchua.app/for-ai-agents

Quickstart: Connect in Your MCP Client

No API keys or local dependencies are required. Point your MCP client directly to https://dungchua.app/api/mcp.

1. Cursor

Copy .cursor/mcp.json into your project's .cursor/mcp.json (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "dungchua": {
      "type": "http",
      "url": "https://dungchua.app/api/mcp"
    }
  }
}

2. Claude Code

Add the remote Streamable HTTP server directly from your terminal:

claude mcp add --transport http dungchua https://dungchua.app/api/mcp

3. Claude Desktop

  • Option A (Connectors UI): Open Settings → Connectors → Add custom connector and enter https://dungchua.app/api/mcp.
  • Option B (claude_desktop_config.json): See claude_desktop_config.json. Keep only one entry matching your Claude Desktop version:
    • Direct HTTP (newer clients): "type": "http", "url": "https://dungchua.app/api/mcp"
    • Local mcp-remote stdio bridge (for clients requiring a local command):
{
  "mcpServers": {
    "dungchua": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dungchua.app/api/mcp"
      ]
    }
  }
}

4. Windsurf

Add Đúng Chưa? to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "dungchua": {
      "serverUrl": "https://dungchua.app/api/mcp"
    }
  }
}

5. Antigravity

In Antigravity's MCP configuration (mcp_config.json), register the remote Streamable HTTP endpoint:

{
  "mcpServers": {
    "dungchua": {
      "serverUrl": "https://dungchua.app/api/mcp"
    }
  }
}

Available MCP Tools

ToolPurposeRequired Arguments
dungchua_get_tone_guideRetrieve acoustic pitch contour (Chao notation), phonation cue, minimal-pair syllable (ma, mà, má, mả, mã, mạ), and practice URL for any of the 6 Northern Vietnamese tones.tone ("ngang" | "huyen" | "sac" | "hoi" | "nga" | "nang")
dungchua_evaluate_recording_gatesDeterministically evaluate whether a learner audio frame summary passes Đúng Chưa?'s acoustic DSP admission gates (SNR >= 10 dB, clean_voiced_frames >= 25, clean_voiced_ratio >= 0.45) or must return ABSTAIN_UNCLEAR_RECORDING.snr_db (number), clean_voiced_frames (integer), clean_voiced_ratio (number, 0.0 to 1.0)

Tool Example (dungchua_get_tone_guide)

curl -fsS -X POST https://dungchua.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "dungchua_get_tone_guide",
      "arguments": { "tone": "nga" }
    }
  }'

Tool Example (dungchua_evaluate_recording_gates)

curl -fsS -X POST https://dungchua.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "dungchua_evaluate_recording_gates",
      "arguments": {
        "snr_db": 14,
        "clean_voiced_frames": 32,
        "clean_voiced_ratio": 0.65
      }
    }
  }'

Available MCP Resources

The server implements resources/list and resources/read across 4 application/json resources:

Resource URINameDescription
dungchua://productĐúng Chưa? product summaryCanonical, claim-safe description of Đúng Chưa?.
dungchua://methodologyĐúng Chưa? methodology and limitsSafe 5-step practice loop, quiet-room scoping, and product boundaries.
dungchua://routesĐúng Chưa? canonical routesPublic product, practice, and discovery URLs.
dungchua://specificationsĐúng Chưa? technical and operational specificationsMeasurable DSP admission gates (10 dB SNR, 25 clean voiced frames, 0.45 voiced ratio), YIN F0 + semitone DTW engine, glottal phonation checks, and Northern dialect baseline.

Discovery & Verification Endpoints


Scope, Safety & Acoustic Boundaries

  • Quiet-Room Practice First: Signal admission requires SNR >= 10 dB, at least 25 clean voiced F0 frames, and >= 0.45 clean voiced ratio. Audio that fails admission returns ABSTAIN rather than fabricated feedback.
  • Controlled Northern Baseline: Early drills target the Northern Vietnamese (Hanoi) 6-tone system, including glottal constriction checks for ngã [35ˀ] and nặng [21ˀ].
  • No ASR Tone Judging: Non-tonal ASR transcription is not used as a tone judge. Pitch evaluation uses YIN F0 tracking and semitone-normalized Dynamic Time Warping (DTW).
  • Read-Only Public Surface: This MCP server exposes no learner recordings, voice biometrics, user accounts, or billing mutations.
  • Product Access: Free browser preview at https://dungchua.app/practice; Pro plans ($12/mo, $69/yr, or $19 30-day pass) at https://dungchua.app/pricing.

Verify Live Endpoint

Run the included smoke test against the live endpoint:

chmod +x examples/verify-mcp.sh
./examples/verify-mcp.sh

License

MIT — see LICENSE. Published by Dung Chua Operations (support@dungchua.app).

No installation packages available.

Remote