I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

nats-mcp-server
MCP server for NATS messaging system using NATS CLI - enabling AI agents to interact with NATS messaging
1
Github Watches
1
Github Forks
3
Github Stars
NATS MCP Server
An MCP (Model Context Protocol) server that provides access to NATS, a cloud native messaging system, through the NATS CLI.
Features
- Publish messages with advanced options (headers, templates, reply subjects)
- Subscribe to subjects with configurable timeouts and message counts
- Request-reply pattern support with headers
- Full NATS CLI integration
- Error handling and cleanup
Requirements
- Node.js >= 14.0.0
- NATS CLI (nats)
Installing NATS CLI
macOS
Using Homebrew:
brew tap nats-io/nats-tools
brew install nats-io/nats-tools/nats
Linux
Using snap:
snap install nats
Using apt (Debian/Ubuntu):
# First, add the NATS repository
echo "deb https://dl.nats.io/nats-io/repo/deb nats release" | sudo tee /etc/apt/sources.list.d/nats.list
curl -fsSL https://dl.nats.io/nats-io/repo/deb/gpg.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/nats.gpg
# Then install
sudo apt-get update
sudo apt-get install nats-server
Using yum (RHEL/CentOS):
# Add the NATS repository
echo "[nats]
name=NATS Repository
baseurl=https://dl.nats.io/nats-io/repo/rpm/centos/\$releasever/\$basearch
gpgcheck=1
gpgkey=https://dl.nats.io/nats-io/repo/rpm/gpg.key
enabled=1" | sudo tee /etc/yum.repos.d/nats.repo
# Install
sudo yum install nats-server
Windows
Using Chocolatey:
choco install nats-io-client
Using Scoop:
scoop bucket add nats https://github.com/nats-io/scoop-bucket.git
scoop install nats
Manual installation:
- Download the latest release from NATS CLI Releases
- Extract the archive
- Add the binary to your system PATH
Building from Source
If packages are not available for your system:
# Requires Go 1.16+
go install github.com/nats-io/natscli/nats@latest
Verifying Installation
After installation, verify the CLI works:
# Check version
nats --version
# Test connection to default server
nats ping
# List available commands
nats help
Installation
# Install from npm
npm install @modelcontextprotocol/nats-mcp-server
# Or clone and build from source
git clone https://github.com/bmorphism/nats-mcp-server.git
cd nats-mcp-server
npm install
npm run build
Configuration
The server can be configured using environment variables:
-
NATS_URL
: NATS server URL (default: 'nats://localhost:4222')
Usage
The server provides the following MCP tools:
publish
Publish a message to a NATS subject with advanced options.
Parameters:
-
subject
(required): NATS subject to publish to -
message
(required): Message to publish -
reply
(optional): Reply subject for request-reply patterns -
headers
(optional): Array of message headers (key-value pairs) -
count
(optional): Number of messages to publish -
sleep
(optional): Sleep duration between messages (e.g., "100ms") -
template
(optional): Enable Go template processing in message
Example with templates:
const result = await mcp.useTool("nats", "publish", {
subject: "greetings",
message: "Message {{Count}} @ {{Time}}",
count: 5,
sleep: "1s",
template: true
});
Example with headers:
const result = await mcp.useTool("nats", "publish", {
subject: "orders",
message: "New order received",
headers: [
{ key: "OrderId", value: "12345" },
{ key: "Priority", value: "high" }
]
});
subscribe
Subscribe to a NATS subject and receive messages.
Parameters:
-
subject
(required): NATS subject to subscribe to -
timeout
(optional): Subscription timeout in milliseconds (default: 5000) -
count
(optional): Number of messages to receive before exiting -
raw
(optional): Show only message payload
Example:
const result = await mcp.useTool("nats", "subscribe", {
subject: "greetings",
timeout: 10000,
count: 5,
raw: true
});
request
Send a request message and wait for a reply.
Parameters:
-
subject
(required): NATS subject to send request to -
message
(required): Request message -
timeout
(optional): Request timeout in milliseconds (default: 5000) -
headers
(optional): Array of request headers (key-value pairs)
Example:
const result = await mcp.useTool("nats", "request", {
subject: "service.time",
message: "What time is it?",
timeout: 3000,
headers: [
{ key: "Locale", value: "en-US" }
]
});
Template Functions
When using templates (template: true), the following functions are available:
-
Count
: Message number -
TimeStamp
: RFC3339 format current time -
Unix
: Seconds since 1970 in UTC -
UnixNano
: Nano seconds since 1970 in UTC -
Time
: Current time -
ID
: Unique ID -
Random(min, max)
: Random string between min and max length
Example with random strings:
const result = await mcp.useTool("nats", "publish", {
subject: "test",
message: "Random data: {{ Random 10 100 }}",
template: true
});
Adding to MCP Configuration
For Cline (VSCode Extension)
Add to ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
:
{
"mcpServers": {
"nats": {
"command": "node",
"args": ["/path/to/nats-mcp-server/build/index.js"],
"env": {
"NATS_URL": "nats://localhost:4222"
}
}
}
}
For Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json
:
{
"mcpServers": {
"nats": {
"command": "node",
"args": ["/path/to/nats-mcp-server/build/index.js"],
"env": {
"NATS_URL": "nats://localhost:4222"
}
}
}
}
Error Handling
The server includes robust error handling for:
- Connection failures
- Invalid parameters
- Timeouts
- Network errors
- NATS-specific errors
- CLI execution errors
Development
To build the project:
npm run build
The build output will be in the build
directory.
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
License
MIT
Acknowledgments
- NATS.io - For the amazing messaging system
- NATS CLI - For the CLI tool
- Model Context Protocol - For the MCP framework
相关推荐
I find academic articles and books for research and literature reviews.
Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.
Confidential guide on numerology and astrology, based of GG33 Public information
Emulating Dr. Jordan B. Peterson's style in providing life advice and insights.
Your go-to expert in the Rust ecosystem, specializing in precise code interpretation, up-to-date crate version checking, and in-depth source code analysis. I offer accurate, context-aware insights for all your Rust programming questions.
This GPT assists in finding a top-rated business CPA - local or virtual. We account for their qualifications, experience, testimonials and reviews. Business operators provide a short description of your business, services wanted, and city or state.
Advanced software engineer GPT that excels through nailing the basics.
Converts Figma frames into front-end code for various mobile frameworks.
Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.
The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.
Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
Mirror ofhttps://github.com/agentience/practices_mcp_server
🧑🚀 全世界最好的LLM资料总结(Agent框架、辅助编程、数据处理、模型训练、模型推理、o1 模型、MCP、小语言模型、视觉语言模型) | Summary of the world's best LLM resources.
Reviews

user_kTYn0HTI
As a devoted MCP application user, I must say that Script by nguyenvanduocit is an outstanding tool. This script seamlessly integrates into my workflow, making my tasks easier and more efficient. The user-friendly interface and clear welcoming information make it accessible even for those new to scripting. Highly recommended for anyone looking to enhance their productivity! Check it out here: https://mcp.so/server/script/nguyenvanduocit