Oatpp Mcp

What is Oatpp Mcp about?

Oatpp Mcp adds Model Context Protocol support to the Oat++ web‑framework. It lets developers expose prompts, resources, and tool definitions directly from their Oat++ ApiController, allowing large language models to discover and invoke API functionality automatically.

How to use Oatpp Mcp?

1. Install Oat++ – the core library is required.
2. Clone the repository and build:

   mkdir build && cd build
   cmake ..
   make install
   

3. Create an oatpp::mcp::Server instance in your application.
4. Register prompts, resources, and tools with addPrompt, addResource, and addTool.
5. Choose a transport:
   • STDIO – call server.stdioListen(); (redirect Oat++ logging to another stream).
   • HTTP SSE – add server.getSseController() to an HTTP router.

Key Features

• Autogenerated LLM tools from Oat++ ApiController definitions.
• Supports two transports: STDIO and HTTP Server‑Sent Events.
• Built‑in prompt types (e.g., CodeReview).
• Built‑in resource types (e.g., file access).
• Built‑in tool implementations (e.g., logger).
• Fully compatible with the official Model Context Protocol specification (prompts, resources, tools).

Use Cases

• Building AI‑augmented micro‑services where LLMs can call your C++ APIs directly.
• Creating code‑review assistants that inspect repository files via the File resource.
• Deploying interactive CLI utilities that communicate with LLMs over STDIO.
• Integrating LLM‑driven automation into existing Oat++ HTTP services using SSE.

FAQ

Q: Do I need to write any protocol handling code? A: No. The library handles serialization, transport, and the MCP spec; you only provide prompts, resources, and tools.

Q: Can I use a custom logger? A: Yes. Redirect Oat++ logging to a file or your own logger before starting the server.

Q: Is there an example project? A: See the example‑crud branch of the Oat++ example repository and the test ServerTest.cpp under test/oatpp-mcp/app/.

Q: Which Oat++ version is required? A: The library depends on the main Oat++ module; any recent stable release works.

oatpp-mcp

Anthropic’s Model Context Protocol implementation for Oat++

Read more:

• About Oat++
• Oat++ Repository
• Model Context Protocol

Supported features

Autogenerated tools for API

:tada: oatpp-mcp can automatically generate tools from ApiController so that you can query your API with LLM. :tada:

• Detailed tutorial
• Example project example-crud (branch add_mcp_server)

Transport

• STDIO
• HTTP SSE

Server features

• Prompts
• Resources
• Tools

Build And Install

Pre Requirements

• Install the main oatpp module

Install module

• Clone this repository.
• In the root of the repository run:

  mkdir build && cd build
  cmake ..
  make install
  

Examples

Find working example in tests /test/oatpp-mcp/app/ServerTest.cpp

Serve via STDIO

Note: make sure to redirect oatpp logging to a different stream - ex.: to file by providing custom Logger.

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

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

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

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

Serve via SSE

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

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

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

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