🧰 NATS MCP toolbox
@hofer
This is a collection of cli tools to expose MCP tools via NATS microservices. It can be used either standalone (exposing existing MCP Servers via NATS) or as library in Go to expose functions as tools.
Overview
What is NATS MCP toolbox?
A collection of CLI tools that expose MCP (Model Context Protocol) tools via NATS microservices. It can be used standalone to expose local or existing MCP servers over NATS, or as a Go library to expose functionality as tools.
How to use NATS MCP toolbox?
Run ./nats-mcp tool --url <nats-server> --command <mcp-server-binary> [args] to expose an existing MCP server via NATS. Use ./nats-mcp client list --url <nats-server> to list available tools. Configure a local agent by adding ./nats-mcp server --url <nats-server> to your MCP config. The NATS_URL environment variable sets the default NATS server URL.
Key features of NATS MCP toolbox
- Exposes MCP tools via NATS microservices
- Can be used standalone or as a Go library
- Supports exposing existing MCP servers over NATS
- Provides a command to list available tools
- Works with local agents through MCP configuration
- Uses
NATS_URLenvironment variable for default URLs
Use cases of NATS MCP toolbox
- Expose an existing MCP server so it can be accessed via NATS
- List available MCP tools on a NATS server
- Connect a local agent to tools exposed via NATS
- Embed as a Go library to implement new MCP tools
FAQ from NATS MCP toolbox
What does NATS MCP toolbox do?
It provides CLI tools to expose MCP tools as NATS microservices, allowing local agents to discover and invoke them over NATS.
How do I expose an existing MCP server?
Run the command: ./nats-mcp tool --url <nats-url> --command <path-to-mcp-server> [args].
How do I list available tools on a NATS server?
Use: ./nats-mcp client list --url <nats-url>.
How do I use it with my local agent?
Add ./nats-mcp server --url <nats-url> to your MCP client configuration so the agent can connect to NATS‑exposed tools.
What are the runtime requirements?
A NATS server and the compiled nats-mcp binary. The NATS_URL environment variable is used as a default for the --url parameter.