modelcontextprotocol
Four Model Context Protocol (MCP) servers in a single Rust binary,
implementing the MCP 2026-07-28 specification
over stdio:
| Server | Identity | What it does |
|---|---|---|
filesystem |
mcp-filesystem |
Secure read/write access restricted to allowed directories |
fetch |
mcp-fetch |
Fetch URLs, convert HTML to markdown, robots.txt enforcement |
memory |
mcp-memory |
Persistent knowledge-graph memory (entities, relations, observations) as JSONL |
shell |
mcp-shell |
Execute local programs directly with a restricted working directory |
Built on the official Rust SDK (rmcp 3.1). The 2026-07-28 protocol is
stateless: server/discover without an initialize handshake, cache hints
on tools/list, and per-tool annotations.
Full documentation: https://maxylev.github.io/modelcontextprotocol/ (usage, CLI reference, protocol details, security model, tool reference for all 25 tools, coverage matrix, and CI/CD notes).
Installation
Or install directly from source:
The release binary is about 5 MB. Requirements: Rust 1.97+ (MSRV), Linux / macOS / Windows.
Quick start
Both a subcommand form and an equivalent flag form are supported so the binary fits any MCP client. Subcommand form (recommended):
Flag form (--filesystem <DIR>, --fetch, --memory, --shell <DIR>)
is equivalent. See the CLI reference
for all options, conflict rules, and environment variables.
Adding to your MCP client
A tutorial with the exact config file, format, and commands for each client is in the docs: Adding the servers to your MCP client.
Covered clients:
| Client | How to configure |
|---|---|
| opencode v1/v2 | mcp key in opencode.json / opencode.jsonc, or opencode mcp add |
| Claude Desktop | mcpServers in claude_desktop_config.json |
| Claude Code | claude mcp add <name> -- modelcontextprotocol ..., or .mcp.json |
| Codex CLI | [mcp_servers.*] in ~/.codex/config.toml, or codex mcp add |
| Pi agent | pi install npm:pi-mcp-adapter, then mcpServers in .mcp.json / ~/.pi/agent/mcp.json |
| Gemini CLI | mcpServers in ~/.gemini/settings.json, or gemini mcp add |
| Cursor | mcpServers in .cursor/mcp.json / ~/.cursor/mcp.json |
| Windsurf, Zed, VS Code, Continue, Cline, Roo | see the tutorial table |
Validate
Quick smoke test with a generic MCP client: start
modelcontextprotocol memory --memory-file /tmp/smoke.jsonl, list tools
(9 memory tools), call create_entities, call read_graph. More in the
verification guide.
Security — read before you trust
- Shell server: executes arbitrary local programs with the OS permissions of the MCP server process. The working-directory restriction is not a sandbox, and there is no command filter. Only connect it to clients you trust.
- Fetch server: can reach local and internal network addresses (no SSRF protection); only enable it for trusted clients. Requests are bounded by a 30-second timeout and robots.txt policy.
- Filesystem access is restricted to configured directories with symlink protection — access control, not a sandbox.
- See the security model for details.
Development
A gated, real-network acceptance suite (tests/openrouter_e2e.rs, ignored
by default) drives every tool through real OpenRouter roundtrips; it
requires OPENROUTER_API_KEY and spends tokens. Run it with:
OPENROUTER_API_KEY=<key
Docs site: cd docs && npm install, then npm run docs:dev (dev) or
npm run docs:build (build; output in docs/.vitepress/dist). Docs gates
are npm run format:check and npm run docs:build.
Repository layout
src/— the binary:cli.rs(CLI),fs/,fetch/,memory/,shell/(servers),support/(shared access control and helpers).tests/— integration suites per server plus the gated OpenRouter E2E harness (openrouter/).docs/— VitePress documentation site (deployed to GitHub Pages)..github/workflows/— CI (lint + test matrix), docs publishing, and crates.io publishing workflows.
License
MIT