Mcp Cpp Claude

🖥️ Native C++ MCP Server

Give Claude, ChatGPT, and other AI with MCP support direct access to your Linux, Windows, macOS, or Android — no Python, no Node.js, no runtime overhead.

[](https://isocpp.org/)

[](LICENSE) [](https://modelcontextprotocol.io) [](https://www.jsonrpc.org/)

Built from scratch in pure C++ — raw sockets, zero runtime dependencies.

---

✨ What is this?

A Model Context Protocol (MCP) server written in native C++ that lets AI assistants like Claude, ChatGPT, and other AI with MCP support interact directly with your local system (Linux, macOS, or Windows). No Python interpreter, no Node.js runtime — just a lean compiled binary that wakes up in milliseconds.

Connect it to Claude.ai via a tunnel (SSH, ngrok, Cloudflare) and Claude can:

• 📁 Browse your filesystem
• 📄 Read your source files
• ⚙️ Execute shell commands
• 📊 Monitor your system in real-time

 ┌─────────────┐   HTTPS Tunnel   ┌──────────────────┐   localhost:5500  ┌─────────────────┐
 │  Claude.ai  │ ◄──────────────► │  Tunnel (ngrok / │ ◄───────────────► │  MCP C++ Server │
 │   (Web UI)  │  MCP over HTTP   │  SSH / Cloudflare)│   JSON-RPC 2.0   │  (your machine) │
 └─────────────┘                  └──────────────────┘                   └─────────────────┘

---

🛠️ Tools Available

| Tool | Description | |------|-------------| | list_directory | List files & directories with sizes | | read_file | Read text files or specific line ranges (up to 1MB) | | search_files | Recursively search by filename pattern | | get_file_info | File metadata: permissions, owner, timestamps | | get_system_info | OS, kernel, CPU, RAM, disk usage | | list_processes | Running processes sorted by CPU/memory/PID | | list_installed_apps | Discover installed .desktop applications | | run_command | Execute shell commands with timeout protection |

---

⚡ Quick Start

Prerequisites

• GCC / G++ with C++20 support (or MSVC on Windows)
• CMake >= 3.14
• SQLite3:
• Linux: sudo apt install libsqlite3-dev
• macOS: brew install sqlite3
• Windows: Handled automatically via CMake/FetchContent

Build & Run

One-liner (Linux, macOS, & Android (Termux)): This will download the pre-built binary for your architecture and install it.

curl -sSL https://raw.githubusercontent.com/hylmithecoder/mcp-cpp-claude/master/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/hylmithecoder/mcp-cpp-claude/master/install.ps1 | iex

Using git clone (Linux/macOS):

git clone https://github.com/hylmithecoder/mcp-cpp-claude.git
cd mcp-cpp-claude
./install.sh

Manual Build: If you prefer to build from source:

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
./build/mcp

Connect to Claude.ai

When you start the server, it will automatically generate a Client ID and Client Secret (or use existing ones from environment variables).

1. Copy the credentials shown in your terminal.
2. Expose your local port via a tunnel (SSH, ngrok, Cloudflare).
3. Add the URL and credentials in Claude.ai → Settings → Integrations → Add MCP Server.

---

🏗️ Architecture

mcp-cpp-claude/
├── include/
│   ├── server.hpp          # Raw TCP socket HTTP server
│   ├── mcp_handler.hpp     # MCP protocol + JSON-RPC routing
│   ├── system_tools.hpp    # Tool definitions & implementations
│   └── handledb.hpp        # SQLite3 history logging
├── src/
│   ├── main.cpp            # Entry point
│   ├── server.cpp          # HTTP/1.1 parser, thread-per-client
│   ├── mcp_handler.cpp     # initialize / tools/list / tools/call
│   ├── system_tools.cpp    # All 8 tool implementations
│   └── handledb.cpp        # DB init, insert, read
└── CMakeLists.txt

Key design decisions:

• Thread-per-client via pthread — each connection isolated
• Dual response mode — direct HTTP body (Claude.ai web) or SSE stream
• SQLite history — every tool call logged locally for auditability

---

🔒 Security Notice

> ⚠️ run_command executes arbitrary shell commands. Never expose to the public internet without authentication.

For now, use a private tunnel (SSH reverse forwarding to a VPS you control). Bearer token auth is on the roadmap.

---

🗺️ Roadmap

• [x] Bearer token auth — protected by auto-generated credentials
• [ ] Streaming SSE output — real-time stdout for long-running commands
• [x] MCP Resources protocol — resources/list + resources/read
• [x] Zero Configuration — auto-generated credentials on startup
• [x] Windows / macOS support — cross-platform via raw sockets (macOS) / Winsock2 (Win)
• [x] Execution history — SQLite logging of all tool calls

---

🤝 Contributing

PRs welcome! Add new tools in src/system_tools.cpp and register in getToolDefinitions().

---

📄 License

[MIT](LICENSE) — © 2026 Hylmi

---

Built with ❤️ and raw C++ sockets. No frameworks were harmed in the making of this server.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hylmithecoder
• Source: hylmithecoder/mcp-cpp-claude
• License: MIT

Install and usage instructions live in the source repository linked above.