Nereid is a terminal-first workspace for Mermaid-backed diagrams. It combines a `ratatui` TUI, a Model Context Protocol (MCP) server, folder-based
Nereid MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Nereid is a terminal-first workspace for Mermaid-backed diagrams. It combines a ratatui TUI, a Model Context Protocol (MCP) server, folder-based session persistence, and deterministic text renders so humans and AI agents can inspect and.
Once Nereid is connected, these are the calls the assistant has available:
Optional — VISUAL or EDITOR for the in-app Mermaid editor. Nereid falls back to viWalkthroughs — walkthrough_list, walkthrough_current, walkthrough_open, walkthrough_read, walkthrough_stat, walkthrough_get_node, walkthrough_render_textCross — references and objects: xref_list, xref_neighbors, xref_add, xref_remove, object_readQueries — route_find, seq_messages, seq_search, seq_trace, flow_reachable, flow_paths, flow_cycles, flow_unreachable, flow_dead_ends, flow_degreesTask — CommandPath — Purposenereid-session.meta.json — Session id, active diagram and walkthrough ids, diagram index, xrefs, and selection stateKey — ActionSpace — Toggle selected objectPrerequisites — Installing Nereid does not grant unrestricted rights. The same source-available noncommercial license applies to crates.io, Homebrew, GitHubCargo — The Cargo tool exposed by this serverHomebrew — The Homebrew tool exposed by this serverVISUAL or EDITOR for the in-app Mermaid editor. Nereid falls back to vi. Installing Nereid does not grant unrestricted rights. The same source-available noncommercial license applies to crates.io, Homebrew, GitHub Releases, npm, Docker, and@bnomei/nereid on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.
Among the cloud and infrastructure options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Nereid's toolset — Optional, Walkthroughs, Cross and 9 more — is a fair guide to whether it matches your workflow. It is maintained by bnomei; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| Optional | VISUAL or EDITOR for the in-app Mermaid editor. Nereid falls back to vi. |
| Walkthroughs | walkthrough_list, walkthrough_current, walkthrough_open, walkthrough_read, walkthrough_stat, walkthrough_get_node, walkthrough_render_text, walkthrough_diff, walkthrough_apply_ops. |
| Cross | references and objects: xref_list, xref_neighbors, xref_add, xref_remove, object_read. |
| Queries | route_find, seq_messages, seq_search, seq_trace, flow_reachable, flow_paths, flow_cycles, flow_unreachable, flow_dead_ends, flow_degrees. |
| Task | Command |
| Path | Purpose |
| nereid-session.meta.json | Session id, active diagram and walkthrough ids, diagram index, xrefs, and selection state. |
| Key | Action |
| Space | Toggle selected object. |
| Prerequisites | Installing Nereid does not grant unrestricted rights. The same source-available noncommercial license applies to crates.io, Homebrew, GitHub Releases, npm, Docker, and source builds. |
| Cargo | The Cargo tool exposed by this server. |
| Homebrew | The Homebrew tool exposed by this server. |
{
"mcpServers": {
"nereid": {
"command": "npx",
"args": ["-y", "@bnomei/nereid"]
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
VISUAL or EDITOR for the in-app Mermaid editor. Nereid falls back to vi. Installing Nereid does not grant unrestricted rights. The same source-available noncommercial license applies to crates.io, Homebrew, GitHub Releases, npm, Docker, andManage your whole Supabase project in conversation — database, auth, storage, Edge Functions and branches.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.
AWS Labs' official server suite — current AWS docs, CDK guidance, cost analysis and service tools.
Cloud browsers for AI agents — automation sessions that run in Browserbase's fleet, not on your machine.
Workers, KV, R2 and D1 by conversation — Cloudflare's official remote servers for building and observability.
Dashboards, Prometheus and Loki queries, incidents and alerts — observability by conversation.