oatpp-mcp

What is oatpp-mcp?

oatpp-mcp is a C++ library that implements Anthropic's Model Context Protocol (MCP) within the Oat++ framework. It allows developers to build MCP servers that can communicate with Large Language Models (LLMs) to leverage their capabilities for various tasks, particularly for interacting with APIs.

How to use oatpp-mcp?

To use oatpp-mcp, you first need to install the main Oat++ module. Then, clone the oatpp-mcp repository and build it using CMake and make. Once installed, you can create an oatpp::mcp::Server instance. You can then add prompts, resources, and tools to this server. The server can be run via STDIO or integrated into an existing HTTP server using Server-Sent Events (SSE).

Example Usage:

Serve via STDIO:

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

Key Features of oatpp-mcp

• Automatic Tool Generation: oatpp-mcp can automatically generate tools from ApiController instances, allowing LLMs to query your APIs.
• Transport Options: Supports STDIO and HTTP SSE for communication.
• Server Features: Implements key MCP server functionalities including prompts, resources, and tools.

Use Cases of oatpp-mcp

• Building LLM-powered API Gateways: Create servers that expose your existing APIs to LLMs, enabling natural language interaction with your services.
• Automated Code Review: Utilize LLMs for code analysis and review by integrating them through MCP.
• Intelligent File Management: Develop systems where LLMs can interact with and manage files.
• Custom LLM Integrations: Build custom applications that leverage LLMs for various tasks by defining specific prompts, resources, and tools.

FAQ from oatpp-mcp

• What is the Model Context Protocol? The Model Context Protocol (MCP) is a specification by Anthropic that defines how models can interact with external tools and resources, providing them with context to perform tasks.
• Does oatpp-mcp require Oat++? Yes, oatpp-mcp is built on top of the Oat++ web framework, so you need to install the main Oat++ module first.
• Can I use oatpp-mcp with any LLM? oatpp-mcp implements the Model Context Protocol, which is designed for interaction with LLMs that support this protocol. Refer to the specific LLM's documentation for compatibility.
• Where can I find examples? Working examples can be found in the /test/oatpp-mcp/app/ServerTest.cpp directory within the repository.

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