mcpc is a Model Context Protocol library in modern C. It aims to:
- Provide a bridge between low-level infrastructure and AI models
- Explore the maximum capability of the most recent C programming language
Tool | ✅ | 🔨 |
Resource | ✅ | 🔨 |
Prompt | ✅ | 🔨 |
Completion | ✅ | 🔨 |
STDIO Transport | ✅ | 🔨 |
HTTP Transport | 🔨 | 🔨 |
Others | 🔨 | 🔨 |
Linux | ✅ | ✅ | ✅ |
Note: this table roughly shows the state of supporting on some platforms, for more detailed information, check the Modern C Support.
Since mcpc claims to implement everything with the most modern C possible, its building process becomes a little different than many existing building systems or process, the major difference is that: we try to support as many C compilers as possible, even on one platform.
Ideally mcpc will be implemented fully in C23(currently the newest standard), but if a full C23 is missing on a platform, we either downgrade the C standard, or give up the support.
This approach certainly has some benefits and consequences:
- The library can launch on as many platforms as possible, and be able to compiled by as many C compilers as possible.
- There must be a minimum fallback version of C standard that the library targets, currently it is C11.
- C23 features that are not patchable, or require non-trivial amount of effort to patch, will not be used, e.g., N2508, N2645, etc.
- All safety checks and performance optimization will only focus on the platforms with full C23 support.
✅✅ : implemented in C23
🔨✅ : implemented in C11~C17
- : the platform does not exist, or work in progress
Linux:
GCC 10 | 🔨✅ (Debian 11) | - | - |
GCC 12 | - | 🔨✅ (Debian 12) | - |
GCC 13 | - | - | - |
GCC 14 | - | - | ✅✅ (Fedora 41) |
Clang 14 | - | - | - |
Clang 16 | - | - | - |
Clang 18 | - | - | - |
Clang 19 | - | - | ✅✅ (Fedora 41) |
Windows:
MSVC 19 | 🔨✅ | - | - |
Clang 19 | - | - | - |
GCC 14 | - | ✅✅ | ✅✅ |
macOS:
Clang 14 | 🔨✅ | - | - |
Clang 16 | - | 🔨✅ | 🔨✅ |
GCC 14 | 🔨✅ | - | - |
Prerequisites:
- GNU Make
Then
Prerequisites:
- Visual Studio
- GNU Make (winget install ezwinports.make)
Two options to build:
Open "x64 Native Tools Command Prompt", then
"File" - "Open" - "CMake", "Build" - "Build All"
This approach is only for the better debugging experience on Windows, "Build in CMD/PS" takes priority over this one.
API reference can be found at api.md.
Dependencies:
- mjson (already in-tree)
Despite we claim to use modern C, as standard as possible, and as modern as possible, we have some extra conventions, in order to render our code more readable, inclusive and scalable:
- Unless mentioned explicitly, we follow GNU C coding style.
- Prefer functions over macros, use macros only if necessary.
- The type of variables should be reflected in the source code. Use of keyword auto is thus forbidden.
- Names of defined variables that are exposed publicly should be in uppercase, otherwise in lowercase.