Oatpp Mcp

What is Oatpp Mcp about?

Provides a C++ library that brings Model Context Protocol capabilities to Oat++ applications, allowing LLMs to interact with API controllers, invoke generated tools, and access defined resources.

How to use Oatpp Mcp?

1. Build & install

   git clone https://github.com/oatpp/oatpp-mcp.git
   cd oatpp-mcp
   mkdir build && cd build
   cmake ..
   make install
   

2. Create a server in your Oat++ project:

   oatpp::mcp::Server server;
   server.addPrompt(std::make_shared<prompts::CodeReview>());
   server.addResource(std::make_shared<resource::File>());
   server.addTool(std::make_shared<tools::Logger>());
   

3. Run the server
   • STDIO: server.stdioListen();
   • HTTP SSE: add server.getSseController() to your router.

Key Features

• Autogenerated tools for ApiController enabling LLM queries.
• Transport support: STDIO and HTTP Server‑Sent Events.
• Built‑in server components: Prompts, Resources, Tools.
• Easy integration with existing Oat++ services.

Use Cases

• Expose RESTful Oat++ services to LLMs for automated code review, debugging, or data extraction.
• Build LLM‑driven assistants that can invoke file operations, logging, or custom business logic via generated tools.
• Provide interactive LLM interfaces over command‑line (STDIO) or web (SSE) channels.

FAQ

• Do I need an Anthropic account? No, the library itself does not require an API key; you only need one when calling Anthropic models from your application.
• Which build system is required? CMake (standard for Oat++ projects).
• Can I add custom transports? Yes, you can extend the server with additional transport mechanisms.
• Is there example code? See tests/oatpp-mcp/app/ServerTest.cpp and the example‑crud branch on GitHub.

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());