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

Just Domain.

Just.

Just Domain is the domain registrar for businesses built with AI. An AI assistant checks availability and both prices, first year and renewal, and hands back a checkout link for justdomain.ai. Read only by design: no pur

Lumify Sports Intelligence

Lumify

Agent-ready sports intelligence API: live scores, odds, line movement, public betting splits, and explainable bet confidence — via 16 MCP tools at https://lumify.ai/mcp. Get a free key instantly — no signup, email, or ca

Agentic Atlas

Avery Jones

Consult field-tested agent-system design patterns through 8 hosted, read-only tools for orientation, deep reading, relationships, provenance, glossary terms, and publication decisions.

Competitor Tracker & Co.

Competitor Tracker & Co. watches your competitors' websites and tells you what changed. Every week it crawls their pricing, product, messaging and corporate pages, detects the changes that matter, and files a tagged, ran

1Panel

1Panel-dev

🔥 1Panel is a modern, open-source VPS control panel — and the only one with native AI agent support. Run Ollama models, deploy OpenClaw agents, and manage your entire server stack from one clean web interface.

36.1K