Oatpp MCP

oatpp-mcp is an implementation of Anthropic's Model Context Protocol (MCP) based on the Oat++ framework, supporting auto-generated API tools, STDIO and HTTP SSE transmission methods, as well as server functions such as prompts, resources, and tools.

Developer tools Artificial intelligence chatbots #API Tools #Model Protocol #C++ Services #SSE Transmission .cpp

rating : 2.5 points

downloads : 11.8K

update time : 2025-04-29

Open Site

What is Oat++ MCP Server?

The Oat++ MCP Server is a bridge between your existing Oat++ web services and large language models (LLMs). It implements Anthropic's Model Context Protocol to automatically expose your API endpoints as tools that LLMs can understand and use.

How to use Oat++ MCP Server?

Simply add the MCP server to your existing Oat++ project, configure your endpoints, and the server will automatically generate tool definitions that LLMs can interact with through either STDIO or HTTP SSE connections.

Use Cases

Ideal for developers who want to: 1) Quickly make their existing APIs accessible to LLMs 2) Build AI-powered applications without rewriting backend services 3) Create natural language interfaces for complex APIs

Key Features

Auto-generated API Tools

Automatically converts your Oat++ ApiController endpoints into LLM-compatible tools without manual configuration

Multiple Transport Options

Supports both STDIO (for direct process communication) and HTTP SSE (for web-based streaming)

Full MCP Specification Support

Implements Prompts, Resources and Tools as defined in the Model Context Protocol specification

Advantages

Zero-code integration with existing Oat++ APIs

Automatic tool generation saves development time

Lightweight implementation with minimal dependencies

Supports both simple and complex API structures

Limitations

Currently only supports Oat++ framework

Limited to MCP protocol features

STDIO mode requires careful logging configuration

Getting Started

Install Requirements

Ensure you have the main Oat++ module installed before proceeding

Install Oat++ MCP

Clone and build the MCP module

Configure Your Server

Add the MCP server to your existing Oat++ application and configure endpoints

Implementation Examples

Basic STDIO Server

Creating a simple server that communicates via standard input/output

HTTP SSE Endpoint

Adding MCP server as an SSE endpoint to existing HTTP server

Frequently Asked Questions

Do I need to modify my existing API controllers?

What LLMs are compatible with this implementation?

Can I use both STDIO and HTTP SSE simultaneously?

Learning Resources

Oat++ Framework Documentation

Official documentation for the Oat++ web framework

Model Context Protocol Specification

Official MCP protocol specification documents

Example CRUD Project with MCP

Working example demonstrating MCP integration

Medium Tutorial Article

Step-by-step guide to implementing MCP server

🚀 Anthropic Model Context Protocol (MCP) Implementation in Oat++

This project implements Anthropic's Model Context Protocol (MCP) in Oat++. It enables seamless integration of MCP functionalities within the Oat++ framework, facilitating interactions with large language models (LLMs).

🚀 Quick Start

Prerequisites

Install the main Oat++ module.

Installation

Clone this repository.
Run the following commands in the root directory of the repository:

mkdir build && cd build
cmake ..
make install

✨ Features

Automatic API Tool Generation

:tada: oatpp-mcp can automatically generate tools from ApiController, allowing you to query the API using LLMs. :tada:

Detailed Tutorial (Link)
Example Project example-crud (Branch add_mcp_server)

Transmission Methods

STDIO
HTTP SSE

Server Features

💻 Usage Examples

Basic Usage

Serving via STDIO

⚠️ Important Note

Make sure to redirect Oat++ logs to another stream, for example, output to a file through a custom Logger.

/* Create an MCP server */
oatpp::mcp::Server server;

/* Add prompts */
server.addPrompt(std::make_shared<prompts::CodeReview>());

/* Add resources */
server.addResource(std::make_shared<resource::File>());
  
/* Add tools */
server.addTool(std::make_shared<tools::Logger>());

/* Run the server */
server.stdioListen();

Serving via SSE

/* Create an MCP server */
oatpp::mcp::Server server;

/* Add prompts */
server.addPrompt(std::make_shared<prompts::CodeReview>());

/* Add resources */
server.addResource(std::make_shared<resource::File>());
  
/* Add tools */
server.addTool(std::make_shared<tools::Logger>());

/* Add the SSE controller to the HTTP server route */
router->addController(server.getSseController());