Azure Container Apps - AI & MCP Playground

@manekinekko

About Azure Container Apps - AI & MCP Playground

This project showcases how to use the MCP protocol with Azure OpenAI. It provides a simple example to interact with OpenAI's API seamlessly via an MCP server and client.

#azure #mcp #openai #agents #llm

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "azure-openai-mcp-example": {
      "command": "docker",
      "args": [
        "compose",
        "up",
        "-d",
        "--build"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Azure Container Apps - AI & MCP Playground?

This demo application showcases the MCP protocol with OpenAI, Azure OpenAI, and GitHub Models. It provides a terminal application that interacts with a TODO list agent using tools from an MCP server, intended for developers exploring AI agent integration.

How to use Azure Container Apps - AI & MCP Playground?

Clone the repository and run docker-compose up to start containers. Alternatively, install dependencies with npm install per prefix and run npm start --prefix mcp-server-http, mcp-server-sse, and mcp-host in separate terminals. Configure the LLM provider via a .env file with keys like OPENAI_API_KEY, AZURE_OPENAI_ENDPOINT, or GITHUB_TOKEN.

Key features of Azure Container Apps - AI & MCP Playground

Supports SSE and HTTP streaming MCP servers
Integrates with OpenAI, Azure OpenAI, GitHub Models
Uses DocumentDB Local for state persistence
Provides tools for TODO list management
Docker Compose for easy setup
Configurable debug logging via DEBUG env variable

Use cases of Azure Container Apps - AI & MCP Playground

Build a terminal-based AI assistant with tool access
Experiment with MCP protocol using different LLM providers
Develop and test MCP server implementations
Explore integration of AI agents with persistent database storage

FAQ from Azure Container Apps - AI & MCP Playground

How does this server differ from other MCP servers?

This playground focuses on demonstrating MCP with multiple LLM providers and includes both HTTP and SSE transport, a local database, and a host application.

What are the runtime dependencies?

Node.js 22+, Docker, and an OpenAI compatible endpoint (OpenAI API key, GitHub token, or Azure OpenAI endpoint).

Where is agent state stored?

State is stored in DocumentDB Local, a lightweight database running in Docker.

Does it support authentication?

Authentication is a work in progress; currently no token-based auth for the MCP servers.

How can I debug the MCP host?

Set the DEBUG environment variable to mcp:* before starting the host.

Frequently asked questions

How does this server differ from other MCP servers?

This playground focuses on demonstrating MCP with multiple LLM providers and includes both HTTP and SSE transport, a local database, and a host application.

What are the runtime dependencies?

Node.js 22+, Docker, and an OpenAI compatible endpoint (OpenAI API key, GitHub token, or Azure OpenAI endpoint).

Where is agent state stored?

State is stored in DocumentDB Local, a lightweight database running in Docker.

Does it support authentication?

Authentication is a work in progress; currently no token-based auth for the MCP servers.

How can I debug the MCP host?

Set the `DEBUG` environment variable to `mcp:*` before starting the host.

Comments

Basic information

More Cloud & Infrastructure MCP servers

container-use

dagger

Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.

3.9K

🐳 docker-mcp

QuantGeekDev

A docker MCP Server (modelcontextprotocol)

490

MCP Server that interacts with Azure AI Foundry (experimental)

azure-ai-foundry

A MCP Server for Azure AI Foundry: it's now moved to cloud, check the new Foundry MCP Server

252

Sample Serverless MCP Servers

aws-samples

Sample implementations of AI Agents and MCP Servers running on AWS Serverless compute

239

MCP Gateway

mcp-ecosystem

🧩 MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications.

2.2K