Nats MCP Server

🚀 NATS MCP 服務器

NATS MCP 服務器是一個藉助 Nats CLI 訪問 NATS（雲原生消息系統）的 MCP（模型上下文協議）服務器，為用戶提供便捷的消息交互功能。

✨ 主要特性

• 可帶有高級選項（頭、模板、回覆主題）發佈消息。
• 能夠以可配置的超時和消息計數訂閱到指定主題。
• 支持帶有頭信息的請求 - 響應模式。
• 與 NATS CLI 實現完全集成。
• 具備完善的錯誤處理和清理機制。

📦 安裝指南

安裝 NATS CLI

macOS

可使用 Homebrew 進行安裝，命令如下：

brew tap nats-io/nats-tools
brew install nats-io/nats-tools/nats

Linux

• 使用 snap 安裝：

snap install nats

• 使用 apt（Debian/Ubuntu）安裝：

# 首先添加 NATS 倉庫
echo "deb https://dl.nats.io/nats-io/repo/deb stable" | sudo tee /etc/apt/sources.list.d/nats.list
sudo apt update && sudo apt install nats

• 使用 yum（CentOS/RHEL）安裝：

# 首先添加 NATS 倉庫
cat << EOF | sudo tee /etc/yum.repos.d/nats.repo
[nats]
name=NATS - https://nats.io
baseurl=https://dl.bintray.com/nats-io/rpm/centos/\$releasever/\$basearch/
enabled=1
gpgcheck=1
EOF
sudo yum clean all && sudo yum install nats

Windows

使用 winget 安裝：

winget install nats.io.NATS

驗證安裝

安裝完成後，可通過以下命令驗證是否正確安裝：

nats --version

🚀 快速開始

安裝 MCP 服務器

1. 克隆倉庫：

git clone https://github.com/yourusername/nats-mcp-server.git
cd nats-mcp-server

2. 安裝依賴：

npm install

3. 構建項目：

npm run build

4. 啟動服務器：

node build/index.js

💻 使用示例

添加到 MCP 配置

對於 Cline（VSCode 插件）

將以下內容添加到 ~/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"
      }
    }
  }
}

對於 Claude Desktop

將以下內容添加到 ~/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"
      }
    }
  }
}

命令參考

發佈（publish）

發佈一條消息到指定主題，命令如下：

node build/index.js publish --subject <主題> --message "<消息>"

訂閱（subscribe）

訂閱指定主題的消息，命令如下：

node build/index.js subscribe --subject <主題> [--timeout <超時時間>] [--count <消息數量>]

請求（request）

向指定主題發送請求並等待回覆，命令如下：

node build/index.js request --subject <主題> --message "<請求消息>" [--timeout <超時時間>]

模板函數

當使用模板（template: true）時，以下函數可用：

• Count：消息編號
• TimeStamp：RFC3339 格式當前時間
• Unix：UTC 時間自 1970 的秒數
• UnixNano：UTC 時間自 1970 的納秒數
• Time：當前時間
• ID：唯一 ID
• Random(min, max)：指定長度的隨機字符串

示例：

const result = await mcp.useTool("nats", "publish", {
  subject: "test",
  message: "Random data: {{ Random 10 100 }}",
  template: true
});

🔧 技術細節

服務器包含以下錯誤處理：

• 連接失敗
• 無效參數
• 超時
• 網絡錯誤
• NATS 特定錯誤
• CLI 執行錯誤

🚧 開發

1. 克隆倉庫：

git clone https://github.com/yourusername/nats-mcp-server.git
cd nats-mcp-server

2. 安裝依賴：

npm install

3. 構建項目：

npm run build

4. 啟動開發服務器：

node build/index.js

👥 貢獻

1. 叉倉庫。
2. 創建功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改（git commit -m 'Add some amazing feature'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 打開 Pull Request。

📄 許可證

本項目採用 MIT 許可證。

🙏 致謝

• NATS.io：高性能分佈式系統通信協議。
• Claude：強大的 AI 助手。