atic/chunks/1358-51104e2af656c119.js","2439","static/chunks/app/%5Blocale%5D/(default)/tag/%5Bname%5D/page-e01bef69b5169e46.js"],"PageTitleTabs"] 23:I[85939,["7626","static/chunks/f6ab4fea-4425dae3da7674a3.js","5232","static/chunks/5232-db5923cda78a4960.js","6465","static/chunks/6465-6b79f1dc957ae3f4.js","9388","static/chunks/9388-d1a745fd53a10850.js","9732","static/chunks/9732-8158987224fdfa35.js","1358","static/chunks/1358-51104e2af656c119.js","2439","static/chunks/app/%5Blocale%5D/(default)/tag/%5Bname%5D/page-e01bef69b5169e46.js"],"default"] 26:I[41664,["7626","static/chunks/f6ab4fea-4425dae3da7674a3.js","5232","static/chunks/5232-db5923cda78a4960.js","6465","static/chunks/6465-6b79f1dc957ae3f4.js","9388","static/chunks/9388-d1a745fd53a10850.js","9732","static/chunks/9732-8158987224fdfa35.js","1358","static/chunks/1358-51104e2af656c119.js","2439","static/chunks/app/%5Blocale%5D/(default)/tag/%5Bname%5D/page-e01bef69b5169e46.js"],"Pagination"] 24:T32ac,# Zig MCP Server

A high-performance implementation of the MCP protocol in Zig

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

--- The Zig MCP Server is a memory-efficient implementation of the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) specification. It provides both a standalone server executable and a library that can be embedded into your Zig applications. ## Features - **Built-in HTTP Server**: - Threaded connection handling with configurable thread pool - Connection limiting to prevent resource exhaustion - Graceful shutdown support - Connection timeout management - Server metrics collection - Health check endpoint - **Memory Efficient**: Uses arena allocators and stack buffers for optimized memory usage - **Multiple Transports**: Supports both stdio and HTTP transports - **Tool System**: Easy API to implement and add custom tools - **MCP 0.4.0 Compatible**: Fully compatible with the latest MCP specification - **Pure Zig**: No external dependencies required - **Reusable Module**: Can be used as a library in other Zig applications - **WebAssembly Support**: Runs on function-as-a-service cloud services based on WebAssembly, such as Fastly Compute ## Requirements - Zig 0.14.0 or later (tested with Zig 0.15.0-dev) ## Building ```bash # Standard build zig build # Optimized for release zig build -Doptimize=ReleaseSmall ``` ## Running ### Using the Command Line ```bash # Run with stdio transport (default) ./zig-out/bin/mcp_server # Run with HTTP transport ./zig-out/bin/mcp_server --transport http --port 7777 # Run with custom thread count and connection limits ./zig-out/bin/mcp_server --transport http --threads 4 --max-connections 500 --timeout 60000 ``` ### Using the Makefile ```bash # Build the project make build # Run with stdio transport make run # Run with HTTP transport make run-http ``` ## Usage ### Standalone Server The standalone server provides ready-to-use MCP functionality with minimal setup. #### Built-in Tools This MCP server comes with the following example tools out of the box: - `echo`: Echoes back any provided parameters - `reverse`: Takes a string input and returns its reverse #### Command-line Options ``` Usage: mcp_server [options] Options: --port, -p Port to listen on (default: 7777) --host, -h Host to bind to (default: 127.0.0.1) --transport, -t Transport to use (stdio, http) (default: stdio) --threads, -j Number of worker threads (default: CPU core count) --max-connections, -c Maximum concurrent connections (default: 1000) --timeout, -T Connection timeout in milliseconds (default: 30000, 0 = no timeout) --help Print this help message Server Endpoints: /jsonrpc Main JSON-RPC endpoint (POST) /health Health check endpoint (GET) ``` #### Advanced Usage ##### Threading Model Th

#fastly

Zig MCP Server