Nats MCP Server

🚀 NATS MCP サーバー

Nats CLI を通じて NATS（クラウドネイティブメッセージングシステム）にアクセスする MCP（モデルコンテキストプロトコル）サーバーです。

✨ 主な機能

• 高度なオプション（ヘッダー、テンプレート、応答トピック）付きでメッセージを公開
• タイムアウトとメッセージ数を設定してトピックにサブスクライブ
• ヘッダー情報付きのリクエスト - レスポンスモードをサポート
• NATS CLI と完全に統合
• エラー処理とクリーンアップ

📦 インストール

必要条件

• Node.js >= 14.0.0
• NATS CLI（nats）

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 アシスタント