ext-apps/examples/transcript-server at main · modelcontextprotocol/ext-apps · GitHub Skip to content Navigation Menu Sign in Appearance settings * Platform * AI CODE CREATION * GitHub Copilot Write better code with AI * GitHub Copilot app Direct agents from issue to merge * MCP Registry Integrate external tools * DEVELOPER WORKFLOWS * Actions Automate any workflow * Codespaces Instant dev environments * Issues Plan and track work * Code Review Manage code changes * Code Quality Enforce quality at merge * APPLICATION SECURITY * GitHub Advanced Security Find and fix vulnerabilities * Code security Secure your code as you build * Secret protection Stop leaks before they start * EXPLORE * Why GitHub * Documentation * Blog * Changelog * Marketplace View all features * Solutions * BY COMPANY SIZE * Enterprises * Small and medium teams * Startups * Nonprofits * BY USE CASE * App Modernization * DevSecOps * DevOps * CI/CD * View all use cases * BY INDUSTRY * Healthcare * Financial services * Manufacturing * Government * View all industries View all solutions * Resources * EXPLORE BY TOPIC * AI * Software Development * DevOps * Security * View all topics * EXPLORE BY TYPE * Customer stories * Events & webinars * Ebooks & reports * Business insights * GitHub Skills * SUPPORT & SERVICES * Documentation * Customer support * Community forum * Trust center * Partners View all resources * Open Source * COMMUNITY * GitHub Sponsors Fund open source developers * PROGRAMS * Security Lab * Maintainer Community * GitHub Stars * Archive Program * REPOSITORIES * Topics * Trending * Collections * Enterprise * ENTERPRISE SOLUTIONS * Enterprise platform AI-powered developer platform * AVAILABLE ADD-ONS * GitHub Advanced Security Enterprise-grade security features * Copilot for Business Enterprise-grade AI features * Premium Support Enterprise-grade 24/7 support * Pricing Search / Sign in Sign up Appearance settings You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert Uh oh! There was an error while loading. Please reload this page . modelcontextprotocol / ext-apps Public * Notifications You must be signed in to change notification settings * Fork 379 * Star 2.8k * Code * Issues 124 * Pull requests 83 * Discussions * Actions * Projects * Security and quality 0 * Insights Additional navigation options * Code * Issues * Pull requests * Discussions * Actions * Projects * Security and quality * Insights Files Expand file tree main Breadcrumbs * ext-apps * / examples / transcript-server / Copy path Directory actions More options More options Directory actions More options More options Latest commit   History History History main Breadcrumbs * ext-apps * / examples / transcript-server / Copy path Top Folders and files Name Name Last commit message Last commit date parent directory .. src src     README.md README.md     grid-cell.png grid-cell.png     main.ts main.ts     mcp-app.html mcp-app.html     package.json package.json     screenshot.png screenshot.png     server.ts server.ts     tsconfig.json tsconfig.json     tsconfig.server.json tsconfig.server.json     vite.config.ts vite.config.ts     View all files README.md Outline Transcript Server An MCP App Server for live speech transcription using the Web Speech API. MCP Client Configuration Add to your MCP client configuration (stdio transport): { "mcpServers" : { "transcript" : { "command" : " npx " , "args" : [ " -y " , " --silent " , " --registry=https://registry.npmjs.org/ " , " @modelcontextprotocol/server-transcript " , " --stdio " ] } } } Local Development To test local modifications, use this configuration (replace ~/code/ext-apps with your clone path): { "mcpServers" : { "transcript" : { "command" : " bash " , "args" : [ " -c " , " cd ~/code/ext-apps/examples/transcript-server && npm run build >&2 && node dist/index.js --stdio " ] } } } Features * Live Transcription : Real-time speech-to-text using browser's Web Speech API * Transitional Model Context : Streams interim transcriptions to the model via ui/update-model-context , allowing the model to see what the user is saying as they speak * Audio Level Indicator : Visual feedback showing microphone input levels * Send to Host : Button to send completed transcriptions as a ui/message to the MCP host * Start/Stop Control : Toggle listening on and off * Clear Transcript : Reset the transcript area Setup Prerequisites * Node.js 20+ * Chrome, Edge, or Safari (Web Speech API support) Installation npm install Running # Development mode (with hot reload) npm run dev # Production build and serve npm run start Usage The server exposes a single tool: transcribe Opens a live speech transcription interface. Parameters: None Example: { "name" : " transcribe " , "arguments" : {} } How It Works * Click Start to begin listening * Speak into your microphone * Watch your speech appear as text in real-time (interim text is streamed to model context via ui/update-model-context ) * Click Send to send the transcript as a ui/message to the host (clears the model context) * Click Clear to reset the transcript Architecture transcript-server/ ├── server.ts # MCP server with transcribe tool ├── server-utils.ts # HTTP transport utilities ├── mcp-app.html # Transcript UI entry point ├── src/ │ ├── mcp-app.ts # App logic, Web Speech API integration │ ├── mcp-app.css # Transcript UI styles │ └── global.css # Base styles └── dist/ # Built output (single HTML file) Notes * Microphone Permission : Requires allow="microphone" on the sandbox iframe (configured via permissions: { microphone: {} } in the resource _meta.ui ) * Browser Support : Web Speech API is well-supported in Chrome/Edge, with Safari support. Firefox has limited support. * Continuous Mode : Recognition automatically restarts when it ends, for seamless transcription Future Enhancements * Language selection dropdown * Whisper-based offline transcription (see TRANSCRIPTION.md) * Export transcript to file * Timestamps toggle Footer (c) 2026 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Community * Docs * Contact * Manage cookies * Do not share my personal information You can’t perform that action at this time.