PubNub MCP Server

by stephenlb

Integrations

  • Provides formatted SDK documentation for PubNub's JavaScript SDK, allowing developers to access reference materials for methods like subscribe() and publish() from within Cursor IDE.

  • Supports PubNub functionality through Node.js, allowing users to publish messages to channels, subscribe to channels, fetch message history, and retrieve presence information.

  • Offers access to PubNub's Python SDK documentation, enabling users to fetch docs for methods like publish() directly through Cursor IDE.

PubNub Model Context Protocol (MCP)-Server für Cursor IDE

Dieses Repository bietet einen CLI-basierten Model Context Protocol (MCP)-Server, der PubNub SDK-Dokumentation und PubNub Functions-Ressourcen für LLM-basierte Tools bereitstellt. Durch das Hinzufügen dieses Servers zur Cursor IDE können Sie:

  • Holen Sie sich die formatierte PubNub JavaScript-, Python- und Java SDK-Dokumentation.
  • Greifen Sie über eine statische Markdown-Datei auf die PubNub-Funktionsdokumentation zu.

Beispiel-Eingabeaufforderungen

  • „Veröffentlichen Sie eine Nachricht im Kanal my_channel mit der Nachricht Hello, PubNub! “.“
  • „Zeigen Sie mir die PubNub JavaScript SDK-Dokumentation für subscribe() .“
  • „Listet alle verfügbaren PubNub-Funktionen auf.“
  • „Holen Sie sich die Python SDK-Dokumente für die Methode publish() .“
  • "Holen Sie den Nachrichtenverlauf für den test ."
  • "Rufen Sie Anwesenheitsinformationen (Belegung und UUIDs) für den test und die default ab."

Dies erfordert Node.js (>= 18) und npm ( https://nodejs.org/ ). npx ruft automatisch den neuesten MCP-Server ab und führt ihn aus.

Voraussetzungen

  • Node.js (>= 18) und npm
  • Cursor-IDE mit MCP-Unterstützung
  • (Optional) PubNub-Konto und API-Schlüssel für Live-Beispiele

Installation

Die bevorzugte Methode, den PubNub MCP-Server lokal auszuführen oder ihn über npx zur Cursor IDE hinzuzufügen:

npx -y @pubnub/mcp

Konfiguration

Der Cursor muss sich im AGENT-MODUS befinden, um MCP-Server verwenden zu können.

Cursor IDE erkennt MCP-Server über eine JSON-Konfigurationsdatei. Konfigurieren Sie den PubNub MCP-Server global oder pro Projekt.

Globale Konfiguration

Bearbeiten oder erstellen Sie ~/.cursor/mcp.json :

{ "mcpServers": { "pubnub": { "command": "npx", "args": ["-y", "@pubnub/mcp"], "env": { "PUBNUB_SUBSCRIBE_KEY": "YOUR_SUBSCRIBE_KEY", "PUBNUB_PUBLISH_KEY": "YOUR_PUBLISH_KEY" } } } }

Projektkonfiguration

Erstellen Sie in Ihrem Projektverzeichnis .cursor/mcp.json :

{ "mcpServers": { "pubnub": { "command": "npx", "args": ["-y", "@pubnub/mcp"], "env": { "PUBNUB_SUBSCRIBE_KEY": "YOUR_SUBSCRIBE_KEY", "PUBNUB_PUBLISH_KEY": "YOUR_PUBLISH_KEY" } } } }
  • command gibt die ausführbare Datei zum Starten des MCP-Servers an.
  • args gibt die an den Befehl zu übergebenden Argumente an.
  • env legt Umgebungsvariablen für den Serverprozess fest.

Verwendung in der Cursor-IDE

  1. Starten Sie Cursor IDE neu oder öffnen Sie eine neue Sitzung.
  2. Öffnen Sie den MCP-Einstellungsbereich und überprüfen Sie, ob der Pubnub -Server unter „Verfügbare Tools und Ressourcen“ aufgeführt ist.
  3. Rufen Sie im Chat verfügbare Ressourcen auf:
    • pubnub://docs/javascript – Fetch PubNub JavaScript SDK-Dokumentation
    • pubnub://docs/python – Fetch PubNub Python SDK-Dokumentation
    • pubnub://docs/java – Fetch PubNub Java SDK-Dokumentation
    • pubnub://functions – Liste der PubNub-Funktionen (statischer Inhalt aus resources/pubnub_functions.md )
  4. Genehmigen Sie die Ressourcenausführung, wenn Sie dazu aufgefordert werden, oder aktivieren Sie die automatische Ausführung in den Einstellungen für vertrauenswürdige Ressourcen.

Claude Code

## Install the MCP server if you have node >= 18 claude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp ## Install the MCP server if you have node < 18 and need to point to the full path of node claude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- /Users/stephen/.nvm/versions/node/v22.14.0/bin/node /Users/stephen/Projects/mcp-pubnub/index.js

Und die Ausgabe wird sein:

Added stdio MCP server pubnub with command: npx -y @pubnub/mcp to local config

Beispiel-Eingabeaufforderung

claude "publish a message 'hi' to the 'my_channel' pubnub channel."
claude "publish a message 'hi' to the 'my_channel' pubnub channel." ╭───────────────────────────────────────────────────╮ │ ✻ Welcome to Claude Code research preview! │ │ │ │ /help for help, /status for your current setup │ │ │ │ cwd: /Users/stephen/Projects/mcp-pubnub │ ╰───────────────────────────────────────────────────╯ ※ Tip: Press Option+Enter to send a multi-line message > publish a message 'hi' to the 'my_channel' pubnub channel. ⏺ I'll publish a message to the PubNub channel for you. ⏺ pubnub:publish_pubnub_message (MCP)(channel: "my_channel", message: "hi")… ⎿  Message published successfully. Timetoken: 17467422499409217 ⏺ Message published successfully to "my_channel".

Entfernen Sie den MCP-Server mit:

claude mcp remove pubnub

Verwenden von Claude Desktop

  1. Fügen Sie im Abschnitt „Tools“ ein neues Tool mit dem Namen „pubnub“ hinzu.
  2. Setzen Sie den Befehl auf npx und die Argumente auf ["-y", "@pubnub/mcp"] .
  3. Fügen Sie Umgebungsvariablen für Ihre PubNub-Schlüssel hinzu:
    • PUBNUB_SUBSCRIBE_KEY
    • PUBNUB_PUBLISH_KEY
  4. Speichern Sie die Konfiguration.

Claude Desktop verwendet möglicherweise eine ältere Node-Version. Möglicherweise müssen Sie den Befehl auf den vollständigen Pfad Ihrer Node-Installation setzen.

git clone https://github.com/stephenlb/pubnub-mcp-server.git

Der MCP-Server befindet sich in der Datei index.js .:

{ "mcpServers": { "pubnub": { "command": "/Users/stephen/.nvm/versions/node/v22.14.0/bin/node", "args": ["/Users/stephen/Projects/mcp-pubnub/index.js"], "env": { "PUBNUB_SUBSCRIBE_KEY": "demo", "PUBNUB_PUBLISH_KEY": "demo" } } } }

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE .

Fehlerbehebung

  • Um MCP-Server verwenden zu können, muss der Agentenmodus aktiviert sein.
  • Überprüfen Sie die Installation von Node.js und npm.
  • Stellen Sie sicher, dass server.js über Ausführungsberechtigung verfügt.
  • Überprüfen Sie, ob die command , args und env korrekt sind.
  • Überprüfen Sie die Cursor-IDE-Protokolle auf MCP-Startfehler.

Direkte JSON-RPC-Befehlszeilenverwendung

Sie können den MCP-Server direkt über STDIN/STDOUT mit JSON-RPC v2.0 aufrufen. Stellen Sie sicher, dass Ihre PubNub-Schlüssel in der Umgebung festgelegt sind, zum Beispiel:

PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \ PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \ node index.js

Sobald der Server läuft (oder einen einmaligen Aufruf verwendet), senden Sie Anfragen, indem Sie JSON in node index.js weiterleiten. Beispiele:

# 1) List available tools echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \ | node index.js # 2) Fetch PubNub JavaScript SDK documentation echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params": {"name":"fetch_pubnub_sdk_docs","arguments":{"language":"javascript"}}}' \ | node index.js # 3) Load PubNub Functions docs (static Markdown) echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params": {"name":"pubnub_functions_docs","arguments":{}}}' \ | node index.js # 4) Publish a message to a channel echo '{"jsonrpc":"2.0","id":4,"method":"tools/call","params": {"name":"publish_pubnub_message","arguments": {"channel":"my_channel","message":"Hello, PubNub!"}}}' \ | node index.js # 5) Read a static resource echo '{"jsonrpc":"2.0","id":5,"method":"resources/read","params": {"uri":"thank_you_pubnub://thank_you"}}' \ | node index.js

Schnelle JSON-RPC-Beispiele

Nachfolgend finden Sie vereinfachte JSON-RPC v2.0-Befehlszeilenbeispiele mit STDIN/STDOUT zum Abrufen der PubNub SDK-Dokumentation und Veröffentlichen von Nachrichten.

1) Holen Sie sich die PubNub JavaScript SDK-Dokumentation

PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \ PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \ echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fetch_pubnub_sdk_docs","arguments":{"language":"javascript"}}}' \ | node index.js

2) Veröffentlichen Sie eine Nachricht in einem PubNub-Kanal

PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \ PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \ echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"publish_pubnub_message","arguments":{"channel":"my_channel","message":"Hello, PubNub MCP JSON-RPC!"}}}' \ | node index.js

Lizenz

MIT

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Ein CLI-basierter Model Context Protocol-Server, der PubNub SDK-Dokumentation und Funktionsressourcen für LLM-basierte Tools wie Cursor IDE verfügbar macht und es Benutzern ermöglicht, Dokumentation abzurufen und über Eingabeaufforderungen in natürlicher Sprache mit PubNub-Kanälen zu interagieren.

  1. Beispiel-Eingabeaufforderungen
    1. Voraussetzungen
      1. Installation
        1. Konfiguration
          1. Globale Konfiguration
          2. Projektkonfiguration
        2. Verwendung in der Cursor-IDE
          1. Claude Code
            1. Beispiel-Eingabeaufforderung
          2. Verwenden von Claude Desktop
            1. Lizenz
              1. Fehlerbehebung
                1. Direkte JSON-RPC-Befehlszeilenverwendung
                  1. Schnelle JSON-RPC-Beispiele
                    1. 1) Holen Sie sich die PubNub JavaScript SDK-Dokumentation
                    2. 2) Veröffentlichen Sie eine Nachricht in einem PubNub-Kanal
                  2. Lizenz

                    Related MCP Servers

                    • -
                      security
                      F
                      license
                      -
                      quality
                      A simple Model Context Protocol server that enables searching and retrieving relevant documentation snippets from Langchain, Llama Index, and OpenAI official documentation.
                      Last updated -
                      Python
                      • Apple
                      • Linux
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A customized MCP server that enables integration between LLM applications and documentation sources, providing AI-assisted access to LangGraph and Model Context Protocol documentation.
                      Last updated -
                      Python
                      • Linux
                      • Apple
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that loads multiple OpenAPI specifications and exposes them to LLM-powered IDE integrations, enabling AI to understand and work with your APIs directly in development tools like Cursor.
                      Last updated -
                      7
                      292
                      7
                      TypeScript
                      MIT License

                    View all related MCP servers

                    ID: u5x3u3txbh