OpenAI MCP Example

Name: OpenAI MCP Example
Author: manekinekko

@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

Basic information

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.

Comments

More AI & Agents MCP servers

🛡️ A.I.G（AI-Infra-Guard）

Tencent

A full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.

4.1K

欢迎来到智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797