OpenAI MCP Example

@manekinekko

About OpenAI MCP Example

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.

#mcp #openai #agents #llm

Config

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

{
  "mcpServers": {
    "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 OpenAI MCP Example?

OpenAI MCP Example is a demo application that showcases the Model Context Protocol (MCP) with OpenAI, Azure OpenAI, and GitHub Models. It provides a terminal-based agent that can perform actions using tools exposed by an MCP server, backed by a DocumentDB Local database.

How to use OpenAI MCP Example?

Run the MCP host after starting the MCP server implementations (HTTP and SSE) and configuring an LLM provider via environment variables. Use npm start --prefix mcp-server-http and npm start --prefix mcp-server-sse to start the servers, then npm start --prefix mcp-host to launch the host agent. Alternatively, use docker compose up to run everything in containers.

Key features of OpenAI MCP Example

Supports Azure OpenAI, OpenAI, and GitHub Models as LLM providers.
Provides both HTTP streaming and SSE (Server-Sent Events) MCP transports.
Includes tools: add_todo, list_todos, complete_todo, delete_todo.
Persists state using DocumentDB Local database.
Debugging via DEBUG=mcp:* environment variable.

Use cases of OpenAI MCP Example

Interact with a shopping list agent that can add, list, complete, and delete items.
Test and compare different MCP transport protocols (HTTP vs SSE) with a single host.
Experiment with multiple LLM providers (OpenAI, Azure OpenAI, GitHub Models) in the same demo.

FAQ from OpenAI MCP Example

What LLM providers are supported?

Azure OpenAI (Responses API), OpenAI (Responses API), and GitHub Models (ChatCompletion API).

What MCP transport protocols are available?

Two implementations are provided: one using HTTP streaming and one using SSE (Server-Sent Events). Both are supported by the host.

How do I run the demo with Docker?

Clone the repository, then run docker compose up to start the MCP servers and DocumentDB Local. Access the MCP host container with docker exec -it mcp-host bash.

What tools does the agent have access to?

The agent can use four tools: add_todo, list_todos, complete_todo, and delete_todo.

How can I enable debug logging?

Set the DEBUG environment variable to mcp:* before starting the MCP host, e.g., DEBUG=mcp:* npm start --prefix mcp-host.

Frequently asked questions

What LLM providers are supported?

Azure OpenAI (Responses API), OpenAI (Responses API), and GitHub Models (ChatCompletion API).

What MCP transport protocols are available?

Two implementations are provided: one using HTTP streaming and one using SSE (Server-Sent Events). Both are supported by the host.

How do I run the demo with Docker?

Clone the repository, then run `docker compose up` to start the MCP servers and DocumentDB Local. Access the MCP host container with `docker exec -it mcp-host bash`.

What tools does the agent have access to?

The agent can use four tools: add_todo, list_todos, complete_todo, and delete_todo.

How can I enable debug logging?

Set the `DEBUG` environment variable to `mcp:*` before starting the MCP host, e.g., `DEBUG=mcp:* npm start --prefix mcp-host`.

Comments

Basic information

More AI & Agents MCP servers

MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About Packages

utensils

MCP-NixOS - Model Context Protocol Server for NixOS resources

739

Hass-MCP

voska

Control and query Home Assistant from Claude and other LLMs — a Model Context Protocol (MCP) server.

307

Just Prompt - A lightweight MCP server for LLM providers

disler

just-prompt is an MCP server that provides a unified interface to top LLM providers (OpenAI, Anthropic, Google Gemini, Groq, DeepSeek, and Ollama)

733

1MCP - One MCP Server for All

1mcp-app

A unified Model Context Protocol server implementation that aggregates multiple MCP servers into one.

468

21st.dev Magic AI Agent

21st-dev

It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic

5.3K