MCP Container (TypeScript)
This is a quick start guide that provides the basic building blocks to set up a remote Model Context Protocol (MCP) server using Azure Container Apps. The MCP server is built using Node.js and TypeScript, and it can be used to run various tools and s
What is MCP Container (TypeScript)?
MCP Container (TypeScript) is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this is a quick start guide that provides the basic building blocks to set up a remote model context protocol (mcp) server using azure container apps. the mcp server is built using node.js and typescr...
This is a quick start guide that provides the basic building blocks to set up a remote Model Context Protocol (MCP) server using Azure Container Apps. The MCP server is built using Node.js and TypeScript, and it can be used to run various tools and s
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- This is a quick start guide that provides the basic building
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-container-tsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Container (TypeScript)
The MCP Container TypeScript sample from Azure Samples is a quickstart template that demonstrates how to deploy a remote MCP server to Azure Container Apps using Node.js and TypeScript. It ships with a working todo-list MCP server (four tools: add_todo, list_todos, complete_todo, delete_todo) backed by in-memory SQLite, JWT-based authentication with role-based access control, and both local development and one-command Azure deployment via the Azure Developer CLI. It serves as a reference architecture for teams building production-grade remote MCP servers on Azure.
Prerequisites
- Node.js 22 or later installed
- Azure Developer CLI (azd) installed for cloud deployment — run 'winget install microsoft.azd' or see https://aka.ms/azd
- Docker Desktop installed (required for dev container support and container builds)
- An Azure subscription with sufficient permissions to create Container Apps resources
Clone the repository
Clone the Azure Samples MCP Container TypeScript repository to your local machine.
git clone https://github.com/Azure-Samples/mcp-container-ts
cd mcp-container-tsInstall dependencies
Install the Node.js dependencies for the project.
npm installGenerate a JWT token for authentication
The server uses JWT authentication. Generate an admin token to get full access. This writes the token configuration to the .env file.
npm run generate-token -- --adminStart the server locally
Run the development server. It will listen on http://localhost:3000/mcp.
npm run devConnect your MCP client to the local server
Configure your MCP client to connect to the local server endpoint with the Bearer token from your .env file. The .vscode/mcp.json file in the repo shows the VS Code configuration format.
{
"mcpServers": {
"mcp-container-ts": {
"type": "http",
"url": "http://localhost:3000/mcp",
"headers": {
"Authorization": "Bearer YOUR_JWT_TOKEN_HERE"
}
}
}
}Deploy to Azure Container Apps (optional)
To deploy the server to Azure for remote access, authenticate with Azure and run azd up. The deployment configures autoscaling, HTTPS, and persistent infrastructure automatically.
azd auth login
azd upMCP Container (TypeScript) Examples
Client configuration
Connect an MCP client to the locally running server. Replace YOUR_JWT_TOKEN_HERE with the token generated by 'npm run generate-token -- --admin'.
{
"mcpServers": {
"mcp-container-ts": {
"type": "http",
"url": "http://localhost:3000/mcp",
"headers": {
"Authorization": "Bearer YOUR_JWT_TOKEN_HERE"
}
}
}
}Prompts to try
After connecting, use these prompts to test the todo-list MCP tools shipped with the sample server.
- "Add a new todo: Review the Azure Container Apps deployment guide"
- "List all my todos"
- "Mark the first todo as complete"
- "Delete all completed todos"
- "How many incomplete todos do I have?"Troubleshooting MCP Container (TypeScript)
401 Unauthorized when connecting to the MCP server
Ensure you generated a JWT token using 'npm run generate-token -- --admin' and are passing it as a Bearer token in the Authorization header of your MCP client config. Check the .env file to confirm the token was written correctly.
azd up fails during Azure deployment
Ensure you're logged in with 'azd auth login' and that your Azure subscription has permissions to create Container Apps, Container Registries, and related resources. Run 'az account show' to confirm your active subscription.
npm run dev fails — port 3000 already in use
Another process is using port 3000. Stop the conflicting process or set a different port with the PORT environment variable: 'PORT=3001 npm run dev'. Update your MCP client URL accordingly.
Frequently Asked Questions about MCP Container (TypeScript)
What is MCP Container (TypeScript)?
MCP Container (TypeScript) is a Model Context Protocol (MCP) server that this is a quick start guide that provides the basic building blocks to set up a remote model context protocol (mcp) server using azure container apps. the mcp server is built using node.js and typescript, and it can be used to run various tools and s It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Container (TypeScript)?
Follow the installation instructions on the MCP Container (TypeScript) GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Container (TypeScript)?
MCP Container (TypeScript) works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Container (TypeScript) free to use?
Yes, MCP Container (TypeScript) is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Container (TypeScript) Alternatives — Similar Cloud Services Servers
Looking for alternatives to MCP Container (TypeScript)? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Container (TypeScript) in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Container (TypeScript)?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.