[{"_1":2,"_464":-5,"_465":-5},"loaderData",{"_3":4,"_22":23,"_288":289},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",16748977,"membership","referenceId","01998214-8e08-73cb-9b71-462d52677519","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_80":-5,"_81":38,"_27":82,"_203":204,"_286":287},"availableLocales",[26,38,45,52,59,66,73],{"_27":28,"_31":35,"_36":37},"mcpServer",{"_29":30,"_31":32,"_33":34},"description","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.","name","PubNub MCP-Server","readme","![MCP-Server-Logo](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-server-model-context-protocol.jpg)\n\n# PubNub Model Context Protocol (MCP)-Server für Cursor IDE\n\nDieses Repository bietet einen CLI-basierten Model Context Protocol (MCP)-Server, der PubNub SDK-Dokumentation und PubNub API-Ressourcen für LLM-basierte Tools bereitstellt. Dies verbessert die Fähigkeit des LLM AI Agent, die SDKs und APIs von PubNub zu verstehen und mit ihnen zu interagieren.\n\n![Mit PubNub MCP vs. ohne](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-vs-no-mcp.jpg)\n\n## Merkmale\n\n* MCP-Server, der Tools für die Interaktion mit PubNub über JSON-RPC über STDIN/STDOUT bereitstellt.\n* Rufen Sie die offizielle PubNub SDK-Dokumentation (HTML → Markdown) ab für:\n * Sprachen: JavaScript, Python, Java, Go, Ruby, Swift, Objective-C, C#, PHP, Rust, Unity, Kotlin, Unreal.\n * API-Referenzabschnitte: Konfiguration, Veröffentlichen und Abonnieren, Präsenz, Zugriffsmanager, Kanalgruppen, Speicherung und Wiedergabe, Mobile-Push, Objekte, Dateien, Nachrichtenaktionen, Sonstiges, Funktionen.\n* Holen Sie sich konzeptionelle Leitfäden und Anleitungen zu PubNub aus lokalen Markdown-Dateien im `resources` (z. B. `pubnub_concepts` , `pubnub_features` , `pubnub_security` , `how_to_send_receive_json` , `how_to_encrypt_messages_files` usw.).\n* Veröffentlichen Sie Nachrichten in PubNub-Kanälen mit `publish_pubnub_message` und geben Sie ein Zeittoken zurück.\n* Rufen Sie mit `get_pubnub_messages` historische Nachrichten aus einem oder mehreren Kanälen ab und geben Sie Nachrichteninhalte und Metadaten in JSON zurück.\n* Rufen Sie mit `get_pubnub_presence` Echtzeit-Präsenzinformationen (Belegungszahlen, Abonnenten-UUIDs) für Kanäle und Kanalgruppen ab.\n* Generieren Sie Schritt-für-Schritt-Anleitungen zum Erstellen einer PubNub-Anwendung, einschließlich Codeausschnitten zum Initialisieren des PubNub SDK in mehreren Sprachen mit `write_pubnub_app` .\n* Konfiguration von Umgebungsvariablen: unterstützt `PUBNUB_PUBLISH_KEY` und `PUBNUB_SUBSCRIBE_KEY` zur Authentifizierung von SDK-Vorgängen.\n* Konvertiert Remote-HTML-Artikel mithilfe von `jsdom` und `turndown` in Markdown für eine konsistente Dokumentationsformatierung.\n* Eingabevalidierung über Zod-Schemata für alle Werkzeugparameter, wodurch eine robuste Fehlerbehandlung gewährleistet wird.\n* Erweiterbare Tooldefinitionen, die das Model Context Protocol SDK ( `@modelcontextprotocol/sdk` ) mit `McpServer` und `StdioServerTransport` nutzen.\n\n## Beispiel-Eingabeaufforderungen\n\n* „Schreiben Sie eine PubNub-App, mit der der Benutzer Streaming-Videos mit integriertem Mehrbenutzer-Chat mit PubNub ansehen kann.“\n* „Schreiben Sie eine PubNub-App für die On-Demand-Lieferung von Lebensmitteln mit einer Karte.“\n* „Schreiben Sie eine PubNub-App, die den Standort eines Pakets in Echtzeit verfolgt.“\n* „Schreiben Sie eine PubNub-App, die die Wettervorhersage in Echtzeit anzeigt.“\n* „Schreiben Sie eine PubNub-App, mit der Benutzer Multiplayer-Spiele mit Freunden spielen können.“\n* „Schreiben Sie eine PubNub-App, die Live-Aktienkurse und Nachrichten-Updates anzeigt.“\n* „Schreiben Sie eine PubNub-App, mit der Benutzer Wiedergabelisten erstellen und mit Freunden teilen können.“\n* „Erstellen Sie eine PubNub-JavaScript-App, die den Kanal `my_channel` abonniert und Nachrichten in der Konsole protokolliert.“\n* „Veröffentlichen Sie eine Nachricht im Kanal `my_channel` mit der Nachricht `Hello, PubNub!` “.“\n* „Zeigen Sie mir die PubNub JavaScript SDK-Dokumentation für `subscribe()` .“\n* „Listet alle verfügbaren PubNub-Funktionen auf.“\n* „Holen Sie sich die Python SDK-Dokumente für die Methode `publish()` .“\n* \"Holen Sie den Nachrichtenverlauf für den `test` .\"\n* \"Rufen Sie Anwesenheitsinformationen (Belegung und UUIDs) für den `test` und die `default` ab.\"\n\nDies erfordert Node.js (>= 18) und npm ( ). `npx` ruft automatisch den neuesten MCP-Server ab und führt ihn aus.\n\n## Voraussetzungen\n\n* Node.js (>= 18) und npm\n* Cursor-IDE mit MCP-Unterstützung\n* (Optional) PubNub-Konto und API-Schlüssel für Live-Beispiele\n\n## Installation\n\nDie bevorzugte Methode, den PubNub MCP-Server lokal auszuführen oder ihn über npx zur Cursor IDE hinzuzufügen:\n\n```bash\nnpx -y @pubnub/mcp\n```\n\n## Konfiguration\n\n> *Der Cursor muss sich im AGENT-MODUS befinden, um MCP-Server verwenden zu können.*\n\nCursor IDE erkennt MCP-Server über eine JSON-Konfigurationsdatei. Konfigurieren Sie den PubNub MCP-Server global oder pro Projekt.\n\n### Globale Konfiguration\n\nBearbeiten oder erstellen Sie `~/.cursor/mcp.json` :\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Projektkonfiguration\n\nErstellen Sie in Ihrem Projektverzeichnis `.cursor/mcp.json` :\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Docker-basierte Konfiguration\n\nWenn Sie den MCP-Server lieber über Docker ausführen möchten, legen Sie Ihre PubNub-Schlüssel als Umgebungsvariablen fest:\n\n```bash\nexport PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY\nexport PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY\n```\n\nKonfigurieren Sie dann Ihre `~/.cursor/mcp.json` (oder `.cursor/mcp.json` in Ihrem Projekt):\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n }\n }\n}\n```\n\n* `command` gibt die ausführbare Datei zum Starten des MCP-Servers an.\n* `args` gibt die an den Befehl zu übergebenden Argumente an.\n* `env` legt Umgebungsvariablen für den Serverprozess fest.\n\n## Verwendung in der Cursor-IDE\n\n1. Starten Sie Cursor IDE neu oder öffnen Sie eine neue Sitzung.\n2. Öffnen Sie den MCP-Einstellungsbereich und überprüfen Sie, ob der **Pubnub** -Server unter **„Verfügbare Tools und Ressourcen“** aufgeführt ist.\n3. Rufen Sie im Chat verfügbare Ressourcen auf:\n * `pubnub://docs/javascript` – Fetch PubNub JavaScript SDK-Dokumentation\n * `pubnub://docs/python` – Fetch PubNub Python SDK-Dokumentation\n * `pubnub://docs/java` – Fetch PubNub Java SDK-Dokumentation\n * `pubnub://functions` – Liste der PubNub-Funktionen (statischer Inhalt aus `resources/pubnub_functions.md` )\n4. 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.\n\n## Claude Code\n\n```shell\n## Install the MCP server if you have node >= 18\nclaude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp\n\n## Install the MCP server if you have node < 18 and need to point to the full path of node\nclaude 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\n\n## Install the MCP server using Docker\n# Ensure your PubNub keys are set as environment variables:\nexport PUBNUB_PUBLISH_KEY=your_publish_key\nexport PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n\n# Depending on your machine’s CPU architecture, you may need to specify the target platform.\n# For example:\n# docker run --platform linux/arm64 -i pubnub/pubnub-mcp-server\n# docker run --platform linux/amd64 -i pubnub/pubnub-mcp-server\n\nclaude mcp add pubnub -- docker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n pubnub/pubnub-mcp-server\n```\n\nUnd die Ausgabe wird sein:\n\n```shell\nAdded stdio MCP server pubnub with command: npx -y @pubnub/mcp to local config\n```\n\n### Beispiel-Eingabeaufforderung\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n```\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n\n╭───────────────────────────────────────────────────╮\n│ ✻ Welcome to Claude Code research preview! │\n│ │\n│ /help for help, /status for your current setup │\n│ │\n│ cwd: /Users/stephen/Projects/mcp-pubnub │\n╰───────────────────────────────────────────────────╯\n\n ※ Tip: Press Option+Enter to send a multi-line message\n\n> publish a message 'hi' to the 'my_channel' pubnub channel.\n\n⏺ I'll publish a message to the PubNub channel for you.\n\n⏺ pubnub:publish_pubnub_message (MCP)(channel: \"my_channel\", message: \"hi\")…\n ⎿ Message published successfully. Timetoken: 17467422499409217\n\n⏺ Message published successfully to \"my_channel\".\n```\n\nEntfernen Sie den MCP-Server mit:\n\n```shell\nclaude mcp remove pubnub\n```\n\n## Verwenden von Claude Desktop\n\nWenn Sie den Docker-basierten MCP-Server in Claude Desktop bevorzugen:\n\n1. Stellen Sie sicher, dass Ihre PubNub-Schlüssel in Ihre Shell exportiert werden:\n\n ```bash\n export PUBNUB_PUBLISH_KEY=your_publish_key\n export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n ```\n\n2. Fügen Sie im Abschnitt **„Tools“** von Claude Desktop ein neues Tool namens **„pubnub“** hinzu.\n\n3. Setzen Sie den **Befehl** auf `docker` .\n\n4. Legen Sie **die Argumente** fest auf:\n\n ```json\n [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n ```\n\n> **Hinweis:** Auf manchen Rechnern (z. B. Apple Silicon) müssen Sie möglicherweise die Docker-Plattform angeben. Fügen Sie im Array „Argumente `\"run\"` `--platform linux/arm64` (oder `--platform linux/amd64` ) ein. Beispiel:\n>\n> ```json\n> [\n> \"run\",\n> \"--platform\", \"linux/arm64\",\n> \"-i\",\n> \"-e\", \"PUBNUB_PUBLISH_KEY\",\n> \"-e\", \"PUBNUB_SUBSCRIBE_KEY\",\n> \"pubnub/pubnub-mcp-server\"\n> ]\n> ```\n\n5. Speichern Sie die Konfiguration.\n\nClaude Desktop ruft den PubNub MCP-Servercontainer über Docker auf.\n\n## Lizenz\n\nDieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei [LICENSE](LICENSE) .\n\n## Fehlerbehebung\n\n* Um MCP-Server verwenden zu können, muss der Agentenmodus aktiviert sein.\n* Überprüfen Sie die Installation von Node.js und npm.\n* Stellen Sie sicher, dass `index.js` über Ausführungsberechtigung verfügt.\n* Überprüfen Sie, ob die `command` , `args` und `env` korrekt sind.\n* Überprüfen Sie die Cursor-IDE-Protokolle auf MCP-Startfehler.\n\n## Direkte JSON-RPC-Befehlszeilenverwendung\n\nSie 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:\n\n```bash\nPUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \\\nPUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \\\n node index.js\n```\n\nSobald der Server läuft (oder einen einmaligen Aufruf verwendet), senden Sie Anfragen, indem Sie JSON in `node index.js` weiterleiten. Beispiele:\n\n```bash\n# 1) List available tools\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' \\\n | node index.js\n\n# 2) Read PubNub JavaScript SDK documentation\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":\n {\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' \\\n | node index.js\n\n# 3) Read PubNub Functions Resource docs (static Markdown)\necho '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_resources\",\"arguments\":{\"document\":\"pubnub_functions\"}}}' \\\n | node index.js\n\n```\n\n## Schnelle JSON-RPC-Beispiele\n\nNachfolgend finden Sie vereinfachte JSON-RPC v2.0-Befehlszeilenbeispiele mit STDIN/STDOUT zum Abrufen der PubNub SDK-Dokumentation und Veröffentlichen von Nachrichten.\n\n### 1) Holen Sie sich die PubNub JavaScript SDK-Dokumentation\n\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' | node index.js\n```\n\n### 2) Veröffentlichen Sie eine Nachricht in einem PubNub-Kanal\n\n```bash\nPUBNUB_PUBLISH_KEY=demo \\\nPUBNUB_SUBSCRIBE_KEY=demo \\\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"publish_pubnub_message\",\"arguments\":{\"channel\":\"my_channel\",\"message\":\"Hello, PubNub MCP JSON-RPC!\"}}}' \\\n | node index.js\n```","German","tag","de-DE",{"_27":39,"_31":43,"_36":44},{"_29":40,"_31":41,"_33":42},"A CLI-based Model Context Protocol server that exposes PubNub SDK documentation and Functions resources to LLM-powered tools like Cursor IDE, enabling users to fetch documentation and interact with PubNub channels via natural language prompts.","PubNub MCP Server","![MCP Server Logo](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-server-model-context-protocol.jpg)\n\n# PubNub Model Context Protocol (MCP) Server for Cursor IDE\n\nThis repository provides a CLI-based Model Context Protocol (MCP) server that exposes PubNub SDK documentation and PubNub API resources to LLM-powered tools.\nThis improves the LLM AI Agent's ability to understand and interact with PubNub's SDKs and APIs.\n\n![With PubNub MCP vs Without](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-vs-no-mcp.jpg)\n\n## Features\n\n- MCP server exposing tools for interacting with PubNub via JSON-RPC over STDIN/STDOUT.\n- Retrieve official PubNub SDK documentation (HTML → Markdown) for:\n - Languages: JavaScript, Python, Java, Go, Ruby, Swift, Objective-C, C#, PHP, Rust, Unity, Kotlin, Unreal.\n - API reference sections: configuration, publish-and-subscribe, presence, access-manager, channel-groups, storage-and-playback, mobile-push, objects, files, message-actions, misc, functions.\n- Fetch PubNub conceptual guides and how-to documentation from local markdown files in the `resources` directory (e.g., `pubnub_concepts`, `pubnub_features`, `pubnub_security`, `how_to_send_receive_json`, `how_to_encrypt_messages_files`, etc.).\n- Publish messages to PubNub channels with `publish_pubnub_message`, returning a timetoken.\n- Fetch historical messages from one or more channels with `get_pubnub_messages`, returning message content and metadata in JSON.\n- Retrieve real-time presence information (occupancy counts, subscriber UUIDs) for channels and channel groups with `get_pubnub_presence`.\n- Generate step-by-step instructions for creating a PubNub application, including code snippets for initializing the PubNub SDK in multiple languages using `write_pubnub_app`.\n- Environment variable configuration: supports `PUBNUB_PUBLISH_KEY` and `PUBNUB_SUBSCRIBE_KEY` for authenticating SDK operations.\n- Converts remote HTML articles to Markdown using `jsdom` and `turndown` for consistent documentation formatting.\n- Input validation via Zod schemas for all tool parameters, ensuring robust error handling.\n- Extensible tool definitions leveraging the Model Context Protocol SDK (`@modelcontextprotocol/sdk`) with `McpServer` and `StdioServerTransport`.\n\n## Example Prompts\n\n- \"Write a PubNub app that lets the user watch streaming videos with built-in multi-user chat with PubNub.\"\n- \"Write a PubNub app for on-demand delivery of groceries with a map.\"\n- \"Write a PubNub app that tracks the location of a package in real-time.\"\n- \"Write a PubNub app that shows the weather forecast in real-time.\"\n- \"Write a PubNub app that lets users play multiplayer games with friends.\"\n- \"Write a PubNub app that shows live stock prices and news updates.\"\n- \"Write a PubNub app that lets users create and share playlists with friends.\"\n- \"Build a PubNub JavaScript app that subscribes to the `my_channel` channel and logs messages to the console.\"\n- \"Publish a message to the `my_channel` channel with the message `Hello, PubNub!`.\"\n- \"Show me the PubNub JavaScript SDK documentation for `subscribe()`.\"\n- \"List all available PubNub Functions.\"\n- \"Fetch the Python SDK docs for the `publish()` method.\"\n- \"Fetch the message history for the `test` channel.\"\n- \"Retrieve presence information (occupancy and UUIDs) for the `test` channel and the `default` channel group.\"\n\nThis requires Node.js (>= 18) and npm (https://nodejs.org/).\n`npx` will automatically fetch and run the latest MCP server.\n\n## Prerequisites\n\n- Node.js (>= 18) and npm\n- Cursor IDE with MCP support\n- (Optional) PubNub account and API keys for live examples\n\n## Installation\n\nThe preferred way to run the PubNub MCP server locally or add it to Cursor IDE via npx:\n\n```bash\nnpx -y @pubnub/mcp\n```\n\n## Configuration\n\n> *Cursor must be in AGENT MODE to use MCP servers.*\n\nCursor IDE discovers MCP servers via a JSON config file.\nConfigure the PubNub MCP server globally or per project.\n\n### Global Configuration\n\nEdit or create `~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Project Configuration\n\nIn your project directory, create `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Docker-Based Configuration\n\nIf you prefer to run the MCP server via Docker, set your PubNub keys as environment variables:\n\n```bash\nexport PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY\nexport PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY\n```\n\nThen configure your `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project):\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n }\n }\n}\n```\n\n- `command` specifies the executable to launch the MCP server.\n- `args` specifies the arguments to pass to the command.\n- `env` sets environment variables for the server process.\n\n## Using in Cursor IDE\n\n1. Restart Cursor IDE or open a new session.\n2. Open the MCP settings pane and verify the **pubnub** server is listed under **Available Tools & Resources**.\n3. In chat, invoke available resources:\n - `pubnub://docs/javascript` — Fetch PubNub JavaScript SDK documentation\n - `pubnub://docs/python` — Fetch PubNub Python SDK documentation\n - `pubnub://docs/java` — Fetch PubNub Java SDK documentation\n - `pubnub://functions` — List PubNub Functions (static content from `resources/pubnub_functions.md`)\n4. Approve resource execution when prompted, or enable **auto-run** in settings for trusted resources.\n\n## Claude Code\n\n```shell\n## Install the MCP server if you have node >= 18\nclaude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp\n\n## Install the MCP server if you have node < 18 and need to point to the full path of node\nclaude 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\n\n## Install the MCP server using Docker\n# Ensure your PubNub keys are set as environment variables:\nexport PUBNUB_PUBLISH_KEY=your_publish_key\nexport PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n\n# Depending on your machine’s CPU architecture, you may need to specify the target platform.\n# For example:\n# docker run --platform linux/arm64 -i pubnub/pubnub-mcp-server\n# docker run --platform linux/amd64 -i pubnub/pubnub-mcp-server\n\nclaude mcp add pubnub -- docker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n pubnub/pubnub-mcp-server\n```\n\nAnd the output will be:\n```shell\nAdded stdio MCP server pubnub with command: npx -y @pubnub/mcp to local config\n```\n\n### Example prompt\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n```\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n\n╭───────────────────────────────────────────────────╮\n│ ✻ Welcome to Claude Code research preview! │\n│ │\n│ /help for help, /status for your current setup │\n│ │\n│ cwd: /Users/stephen/Projects/mcp-pubnub │\n╰───────────────────────────────────────────────────╯\n\n ※ Tip: Press Option+Enter to send a multi-line message\n\n> publish a message 'hi' to the 'my_channel' pubnub channel.\n\n⏺ I'll publish a message to the PubNub channel for you.\n\n⏺ pubnub:publish_pubnub_message (MCP)(channel: \"my_channel\", message: \"hi\")…\n ⎿ Message published successfully. Timetoken: 17467422499409217\n\n⏺ Message published successfully to \"my_channel\".\n```\n\nRemove the MCP server with:\n\n```shell\nclaude mcp remove pubnub\n```\n\n## Using Claude Desktop\n\nIf you prefer the Docker-based MCP server in Claude Desktop:\n\n1. Ensure your PubNub keys are exported in your shell:\n ```bash\n export PUBNUB_PUBLISH_KEY=your_publish_key\n export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n ```\n2. In the **Tools** section of Claude Desktop, add a new tool named **pubnub**.\n3. Set the **Command** to `docker`.\n4. Set **Arguments** to:\n ```json\n [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n ```\n\n> **Note:** On some machines (e.g., Apple Silicon), you may need to specify the Docker platform.\n> Insert `--platform linux/arm64` (or `--platform linux/amd64`) immediately after `\"run\"` in the Arguments array. For example:\n>\n> ```json\n> [\n> \"run\",\n> \"--platform\", \"linux/arm64\",\n> \"-i\",\n> \"-e\", \"PUBNUB_PUBLISH_KEY\",\n> \"-e\", \"PUBNUB_SUBSCRIBE_KEY\",\n> \"pubnub/pubnub-mcp-server\"\n> ]\n> ```\n5. Save the configuration.\n\nClaude Desktop will invoke the PubNub MCP server container via Docker.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Troubleshooting\n\n- Must be in agent mode to use MCP servers.\n- Verify Node.js and npm installation.\n- Ensure `index.js` has execute permission.\n- Check that the `command`, `args`, and `env` settings are correct.\n- Review Cursor IDE logs for MCP startup errors.\n\n## Direct JSON-RPC Command-Line Usage\n\nYou can invoke the MCP server directly over STDIN/STDOUT using JSON-RPC v2.0.\nEnsure your PubNub keys are set in the environment, for example:\n```bash\nPUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \\\nPUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \\\n node index.js\n```\n\nOnce the server is running (or using a one-off invocation), send requests by piping JSON into `node index.js`. Examples:\n```bash\n# 1) List available tools\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' \\\n | node index.js\n\n# 2) Read PubNub JavaScript SDK documentation\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":\n {\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' \\\n | node index.js\n\n# 3) Read PubNub Functions Resource docs (static Markdown)\necho '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_resources\",\"arguments\":{\"document\":\"pubnub_functions\"}}}' \\\n | node index.js\n\n```\n\n## Quick JSON-RPC Examples\n\nBelow are simplified JSON-RPC v2.0 command-line examples using STDIN/STDOUT to fetch PubNub SDK documentation and publish messages.\n\n### 1) Fetch PubNub JavaScript SDK documentation\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' | node index.js\n```\n\n### 2) Publish a message to a PubNub channel\n```bash\nPUBNUB_PUBLISH_KEY=demo \\\nPUBNUB_SUBSCRIBE_KEY=demo \\\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"publish_pubnub_message\",\"arguments\":{\"channel\":\"my_channel\",\"message\":\"Hello, PubNub MCP JSON-RPC!\"}}}' \\\n | node index.js\n```\n\n","English","en-US",{"_27":46,"_31":50,"_36":51},{"_29":47,"_31":48,"_33":49},"Un servidor de protocolo de contexto de modelo basado en CLI que expone la documentación del SDK de PubNub y los recursos de funciones a herramientas impulsadas por LLM como Cursor IDE, lo que permite a los usuarios obtener documentación e interactuar con los canales de PubNub a través de indicaciones en lenguaje natural.","Servidor MCP de PubNub","![Logotipo del servidor MCP](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-server-model-context-protocol.jpg)\n\n# Servidor de protocolo de contexto de modelo (MCP) de PubNub para Cursor IDE\n\nEste repositorio proporciona un servidor de Protocolo de Contexto de Modelo (MCP) basado en CLI que expone la documentación del SDK de PubNub y los recursos de la API de PubNub a herramientas basadas en LLM. Esto mejora la capacidad del Agente de IA de LLM para comprender e interactuar con los SDK y las API de PubNub.\n\n![Con PubNub MCP vs. sin él](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-vs-no-mcp.jpg)\n\n## Características\n\n* Servidor MCP que expone herramientas para interactuar con PubNub a través de JSON-RPC sobre STDIN/STDOUT.\n* Recupere la documentación oficial del SDK de PubNub (HTML → Markdown) para:\n * Lenguajes: JavaScript, Python, Java, Go, Ruby, Swift, Objective-C, C#, PHP, Rust, Unity, Kotlin, Unreal.\n * Secciones de referencia de API: configuración, publicación y suscripción, presencia, administrador de acceso, grupos de canales, almacenamiento y reproducción, push móvil, objetos, archivos, acciones de mensajes, varios, funciones.\n* Obtenga guías conceptuales de PubNub y documentación práctica desde archivos markdown locales en el directorio `resources` (por ejemplo, `pubnub_concepts` , `pubnub_features` , `pubnub_security` , `how_to_send_receive_json` , `how_to_encrypt_messages_files` , etc.).\n* Publica mensajes en canales de PubNub con `publish_pubnub_message` y devuelve un token de tiempo.\n* Obtenga mensajes históricos de uno o más canales con `get_pubnub_messages` y devuelva el contenido del mensaje y los metadatos en JSON.\n* Recupere información de presencia en tiempo real (conteos de ocupación, UUID de suscriptores) para canales y grupos de canales con `get_pubnub_presence` .\n* Genere instrucciones paso a paso para crear una aplicación PubNub, incluidos fragmentos de código para inicializar el SDK de PubNub en varios idiomas mediante `write_pubnub_app` .\n* Configuración de la variable de entorno: admite `PUBNUB_PUBLISH_KEY` y `PUBNUB_SUBSCRIBE_KEY` para autenticar operaciones del SDK.\n* Convierte artículos HTML remotos a Markdown usando `jsdom` y `turndown` para un formato de documentación consistente.\n* Validación de entrada a través de esquemas Zod para todos los parámetros de la herramienta, lo que garantiza un manejo sólido de errores.\n* Definiciones de herramientas extensibles que aprovechan el SDK del Protocolo de Contexto de Modelo ( `@modelcontextprotocol/sdk` ) con `McpServer` y `StdioServerTransport` .\n\n## Ejemplos de indicaciones\n\n* \"Escriba una aplicación PubNub que permita al usuario ver videos en streaming con un chat multiusuario integrado con PubNub\".\n* \"Escriba una aplicación PubNub para la entrega a pedido de comestibles con un mapa\".\n* \"Escriba una aplicación PubNub que rastree la ubicación de un paquete en tiempo real\".\n* \"Escribe una aplicación PubNub que muestre el pronóstico del tiempo en tiempo real\".\n* \"Escribe una aplicación PubNub que permita a los usuarios jugar juegos multijugador con amigos\".\n* \"Escribe una aplicación PubNub que muestre precios de acciones en vivo y actualizaciones de noticias\".\n* \"Escribe una aplicación PubNub que permita a los usuarios crear y compartir listas de reproducción con amigos\".\n* \"Cree una aplicación JavaScript de PubNub que se suscriba al canal `my_channel` y registre mensajes en la consola\".\n* \"Publica un mensaje en el canal `my_channel` con el mensaje `Hello, PubNub!` \"\n* \"Muéstrame la documentación del SDK de JavaScript de PubNub para `subscribe()` \".\n* \"Enumere todas las funciones de PubNub disponibles\".\n* \"Obtenga la documentación del SDK de Python para el método `publish()` \".\n* \"Obtener el historial de mensajes del canal `test` \".\n* \"Recuperar información de presencia (ocupación y UUID) para el canal `test` y el grupo de canales `default` \".\n\nEsto requiere Node.js (>= 18) y npm ( ). `npx` buscará y ejecutará automáticamente el último servidor MCP.\n\n## Prerrequisitos\n\n* Node.js (>= 18) y npm\n* IDE de cursor con soporte MCP\n* (Opcional) Cuenta de PubNub y claves API para ejemplos en vivo\n\n## Instalación\n\nLa forma preferida de ejecutar el servidor PubNub MCP localmente o agregarlo a Cursor IDE a través de npx:\n\n```bash\nnpx -y @pubnub/mcp\n```\n\n## Configuración\n\n> *El cursor debe estar en MODO AGENTE para utilizar servidores MCP.*\n\nCursor IDE detecta servidores MCP mediante un archivo de configuración JSON. Configure el servidor MCP de PubNub globalmente o por proyecto.\n\n### Configuración global\n\nEditar o crear `~/.cursor/mcp.json` :\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Configuración del proyecto\n\nEn el directorio de su proyecto, cree `.cursor/mcp.json` :\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Configuración basada en Docker\n\nSi prefiere ejecutar el servidor MCP a través de Docker, configure sus claves PubNub como variables de entorno:\n\n```bash\nexport PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY\nexport PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY\n```\n\nLuego configura tu `~/.cursor/mcp.json` (o `.cursor/mcp.json` en tu proyecto):\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n }\n }\n}\n```\n\n* `command` especifica el ejecutable para iniciar el servidor MCP.\n* `args` especifica los argumentos que se pasarán al comando.\n* `env` establece variables de entorno para el proceso del servidor.\n\n## Uso en Cursor IDE\n\n1. Reinicie Cursor IDE o abra una nueva sesión.\n2. Abra el panel de configuración de MCP y verifique que el servidor **pubnub** esté incluido en **Herramientas y recursos disponibles** .\n3. En el chat, invoca los recursos disponibles:\n * `pubnub://docs/javascript` — Obtener la documentación del SDK de JavaScript de PubNub\n * `pubnub://docs/python` — Obtener la documentación del SDK de Python de PubNub\n * `pubnub://docs/java` — Obtener la documentación del SDK de Java de PubNub\n * `pubnub://functions` — Lista de funciones de PubNub (contenido estático de `resources/pubnub_functions.md` )\n4. Apruebe la ejecución de recursos cuando se le solicite o habilite **la ejecución automática** en la configuración para recursos confiables.\n\n## Claude Code\n\n```shell\n## Install the MCP server if you have node >= 18\nclaude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp\n\n## Install the MCP server if you have node < 18 and need to point to the full path of node\nclaude 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\n\n## Install the MCP server using Docker\n# Ensure your PubNub keys are set as environment variables:\nexport PUBNUB_PUBLISH_KEY=your_publish_key\nexport PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n\n# Depending on your machine’s CPU architecture, you may need to specify the target platform.\n# For example:\n# docker run --platform linux/arm64 -i pubnub/pubnub-mcp-server\n# docker run --platform linux/amd64 -i pubnub/pubnub-mcp-server\n\nclaude mcp add pubnub -- docker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n pubnub/pubnub-mcp-server\n```\n\nY el resultado será:\n\n```shell\nAdded stdio MCP server pubnub with command: npx -y @pubnub/mcp to local config\n```\n\n### Ejemplo de mensaje\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n```\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n\n╭───────────────────────────────────────────────────╮\n│ ✻ Welcome to Claude Code research preview! │\n│ │\n│ /help for help, /status for your current setup │\n│ │\n│ cwd: /Users/stephen/Projects/mcp-pubnub │\n╰───────────────────────────────────────────────────╯\n\n ※ Tip: Press Option+Enter to send a multi-line message\n\n> publish a message 'hi' to the 'my_channel' pubnub channel.\n\n⏺ I'll publish a message to the PubNub channel for you.\n\n⏺ pubnub:publish_pubnub_message (MCP)(channel: \"my_channel\", message: \"hi\")…\n ⎿ Message published successfully. Timetoken: 17467422499409217\n\n⏺ Message published successfully to \"my_channel\".\n```\n\nEliminar el servidor MCP con:\n\n```shell\nclaude mcp remove pubnub\n```\n\n## Uso de Claude Desktop\n\nSi prefiere el servidor MCP basado en Docker en Claude Desktop:\n\n1. Asegúrese de que sus claves PubNub se exporten en su shell:\n\n ```bash\n export PUBNUB_PUBLISH_KEY=your_publish_key\n export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n ```\n\n2. En la sección **Herramientas** de Claude Desktop, agregue una nueva herramienta llamada **pubnub** .\n\n3. Establezca el **comando** en `docker` .\n\n4. Establecer **argumentos** en:\n\n ```json\n [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n ```\n\n> **Nota:** En algunas máquinas (p. ej., Apple Silicon), es posible que deba especificar la plataforma Docker. Inserte `--platform linux/arm64` (o `--platform linux/amd64` ) inmediatamente después de `\"run\"` en la matriz Arguments. Por ejemplo:\n>\n> ```json\n> [\n> \"run\",\n> \"--platform\", \"linux/arm64\",\n> \"-i\",\n> \"-e\", \"PUBNUB_PUBLISH_KEY\",\n> \"-e\", \"PUBNUB_SUBSCRIBE_KEY\",\n> \"pubnub/pubnub-mcp-server\"\n> ]\n> ```\n\n5. Guardar la configuración.\n\nClaude Desktop invocará el contenedor del servidor PubNub MCP a través de Docker.\n\n## Licencia\n\nEste proyecto está licenciado bajo la Licencia MIT. Consulte el archivo [de LICENCIA](LICENSE) para más detalles.\n\n## Solución de problemas\n\n* Debe estar en modo agente para utilizar servidores MCP.\n* Verificar la instalación de Node.js y npm.\n* Asegúrese de que `index.js` tenga permiso de ejecución.\n* Verifique que las configuraciones `command` , `args` y `env` sean correctas.\n* Revise los registros de Cursor IDE para detectar errores de inicio de MCP.\n\n## Uso directo de la línea de comandos JSON-RPC\n\nPuede invocar el servidor MCP directamente a través de STDIN/STDOUT mediante JSON-RPC v2.0. Asegúrese de que sus claves de PubNub estén configuradas en el entorno, por ejemplo:\n\n```bash\nPUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \\\nPUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \\\n node index.js\n```\n\nUna vez que el servidor esté en ejecución (o mediante una invocación única), envíe solicitudes canalizando JSON al `node index.js` . Ejemplos:\n\n```bash\n# 1) List available tools\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' \\\n | node index.js\n\n# 2) Read PubNub JavaScript SDK documentation\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":\n {\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' \\\n | node index.js\n\n# 3) Read PubNub Functions Resource docs (static Markdown)\necho '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_resources\",\"arguments\":{\"document\":\"pubnub_functions\"}}}' \\\n | node index.js\n\n```\n\n## Ejemplos rápidos de JSON-RPC\n\nA continuación se muestran ejemplos simplificados de la línea de comandos JSON-RPC v2.0 que utilizan STDIN/STDOUT para obtener la documentación del SDK de PubNub y publicar mensajes.\n\n### 1) Obtener la documentación del SDK de JavaScript de PubNub\n\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' | node index.js\n```\n\n### 2) Publicar un mensaje en un canal de PubNub\n\n```bash\nPUBNUB_PUBLISH_KEY=demo \\\nPUBNUB_SUBSCRIBE_KEY=demo \\\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"publish_pubnub_message\",\"arguments\":{\"channel\":\"my_channel\",\"message\":\"Hello, PubNub MCP JSON-RPC!\"}}}' \\\n | node index.js\n```","Spanish","es-ES",{"_27":53,"_31":57,"_36":58},{"_29":54,"_31":55,"_33":56},"PubNub SDK ドキュメントと関数リソースを Cursor IDE などの LLM 対応ツールに公開する CLI ベースのモデルコンテキストプロトコルサーバー。これにより、ユーザーはドキュメントを取得したり、自然言語プロンプトを使用して PubNub チャネルと対話したりできるようになります。","PubNub MCP サーバー","![MCP サーバーロゴ](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-server-model-context-protocol.jpg)\n\n# カーソル IDE 用の PubNub モデルコンテキストプロトコル (MCP) サーバー\n\nこのリポジトリは、PubNub SDKドキュメントとPubNub APIリソースをLLM対応ツールに公開するCLIベースのモデルコンテキストプロトコル（MCP）サーバーを提供します。これにより、LLM AIエージェントがPubNubのSDKとAPIを理解し、操作する能力が向上します。\n\n![PubNub MCP あり vs なし](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-vs-no-mcp.jpg)\n\n## 特徴\n\n* STDIN/STDOUT 経由の JSON-RPC を介して PubNub と対話するためのツールを公開する MCP サーバー。\n* 公式 PubNub SDK ドキュメント (HTML → Markdown) を取得します。\n * 言語: JavaScript、Python、Java、Go、Ruby、Swift、Objective-C、C#、PHP、Rust、Unity、Kotlin、Unreal。\n * API リファレンスセクション: 構成、パブリッシュおよびサブスクライブ、プレゼンス、アクセスマネージャー、チャネルグループ、ストレージおよび再生、モバイルプッシュ、オブジェクト、ファイル、メッセージアクション、その他、関数。\n* `resources`ディレクトリ内のローカルマークダウンファイルから PubNub の概念ガイドとハウツードキュメントを取得します (例: `pubnub_concepts` 、 `pubnub_features` 、 `pubnub_security` 、 `how_to_send_receive_json` 、 `how_to_encrypt_messages_files`など)。\n* `publish_pubnub_message`を使用して PubNub チャネルにメッセージを公開し、タイムトークンを返します。\n* `get_pubnub_messages`を使用して 1 つ以上のチャネルから履歴メッセージを取得し、メッセージの内容とメタデータを JSON 形式で返します。\n* `get_pubnub_presence`を使用して、チャネルおよびチャネルグループのリアルタイムのプレゼンス情報 (占有数、サブスクライバー UUID) を取得します。\n* `write_pubnub_app`を使用して複数の言語で PubNub SDK を初期化するためのコードスニペットを含む、PubNub アプリケーションを作成するためのステップバイステップの手順を生成します。\n* 環境変数の構成: SDK 操作の認証に`PUBNUB_PUBLISH_KEY`と`PUBNUB_SUBSCRIBE_KEY`をサポートします。\n* ドキュメントのフォーマットの一貫性を保つために、 `jsdom`と`turndown`を使用してリモート HTML 記事を Markdown に変換します。\n* すべてのツールパラメータに対して Zod スキーマによる入力検証を実行し、堅牢なエラー処理を保証します。\n* `McpServer`および`StdioServerTransport`を使用した Model Context Protocol SDK ( `@modelcontextprotocol/sdk` ) を活用した拡張可能なツール定義。\n\n## プロンプトの例\n\n* 「PubNub のマルチユーザーチャットを組み込んだストリーミングビデオをユーザーが視聴できる PubNub アプリを作成します。」\n* 「地図を使って食料品をオンデマンドで配達する PubNub アプリを作成します。」\n* 「荷物の位置をリアルタイムで追跡する PubNub アプリを作成します。」\n* 「リアルタイムで天気予報を表示する PubNub アプリを作成します。」\n* 「ユーザーが友達とマルチプレイヤーゲームをプレイできる PubNub アプリを作成します。」\n* 「株価とニュースの最新情報をリアルタイムで表示する PubNub アプリを作成します。」\n* 「ユーザーがプレイリストを作成して友人と共有できる PubNub アプリを作成します。」\n* 「 `my_channel`チャネルをサブスクライブし、コンソールにメッセージを記録する PubNub JavaScript アプリを構築します。」\n* 「 `Hello, PubNub!`というメッセージを`my_channel`チャネルに公開します。」\n* 「 `subscribe()`の PubNub JavaScript SDK ドキュメントを表示してください。」\n* 「利用可能なすべての PubNub 関数を一覧表示します。」\n* 「 `publish()`メソッドの Python SDK ドキュメントを取得します。」\n* 「 `test`チャネルのメッセージ履歴を取得します。」\n* 「 `test`チャネルと`default`チャネルグループのプレゼンス情報 (占有状況と UUID) を取得します。」\n\nこれには Node.js (>= 18) と npm ( ) が必要です。npx `npx`最新の MCP サーバーを自動的に取得して実行します。\n\n## 前提条件\n\n* Node.js (>= 18) と npm\n* MCP をサポートするカーソル IDE\n* (オプション) ライブサンプル用の PubNub アカウントと API キー\n\n## インストール\n\nPubNub MCP サーバーをローカルで実行したり、npx 経由で Cursor IDE に追加したりするための推奨方法は次のとおりです。\n\n```bash\nnpx -y @pubnub/mcp\n```\n\n## 構成\n\n> *MCP サーバーを使用するには、カーソルがエージェントモードになっている必要があります。*\n\nCursor IDE は JSON 設定ファイルを介して MCP サーバーを検出します。PubNub MCP サーバーをグローバルまたはプロジェクトごとに設定できます。\n\n### グローバル構成\n\n`~/.cursor/mcp.json`を編集または作成します。\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### プロジェクト構成\n\nプロジェクトディレクトリに`.cursor/mcp.json`を作成します。\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Dockerベースの構成\n\nMCP サーバーを Docker 経由で実行する場合は、PubNub キーを環境変数として設定します。\n\n```bash\nexport PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY\nexport PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY\n```\n\n次に、 `~/.cursor/mcp.json` (またはプロジェクト内の`.cursor/mcp.json` ) を設定します。\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n }\n }\n}\n```\n\n* `command` 、MCP サーバーを起動する実行可能ファイルを指定します。\n* `args`コマンドに渡す引数を指定します。\n* `env`サーバープロセスの環境変数を設定します。\n\n## カーソルIDEでの使用\n\n1. カーソル IDE を再起動するか、新しいセッションを開きます。\n2. MCP 設定ペインを開き、 **pubnub**サーバーが\\*\\*\\[利用可能なツールとリソース]\\*\\*の下にリストされていることを確認します。\n3. チャットで利用可能なリソースを呼び出します。\n * `pubnub://docs/javascript` — PubNub JavaScript SDK ドキュメントを取得します\n * `pubnub://docs/python` — PubNub Python SDK ドキュメントを取得します\n * `pubnub://docs/java` — PubNub Java SDK ドキュメントを取得します\n * `pubnub://functions` — PubNub 関数の一覧を表示します（ `resources/pubnub_functions.md`からの静的コンテンツ）\n4. プロンプトが表示されたらリソースの実行を承認するか、信頼できるリソースの設定で**自動実行**を有効にします。\n\n## クロード・コード\n\n```shell\n## Install the MCP server if you have node >= 18\nclaude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp\n\n## Install the MCP server if you have node < 18 and need to point to the full path of node\nclaude 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\n\n## Install the MCP server using Docker\n# Ensure your PubNub keys are set as environment variables:\nexport PUBNUB_PUBLISH_KEY=your_publish_key\nexport PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n\n# Depending on your machine’s CPU architecture, you may need to specify the target platform.\n# For example:\n# docker run --platform linux/arm64 -i pubnub/pubnub-mcp-server\n# docker run --platform linux/amd64 -i pubnub/pubnub-mcp-server\n\nclaude mcp add pubnub -- docker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n pubnub/pubnub-mcp-server\n```\n\n出力は次のようになります。\n\n```shell\nAdded stdio MCP server pubnub with command: npx -y @pubnub/mcp to local config\n```\n\n### プロンプトの例\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n```\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n\n╭───────────────────────────────────────────────────╮\n│ ✻ Welcome to Claude Code research preview! │\n│ │\n│ /help for help, /status for your current setup │\n│ │\n│ cwd: /Users/stephen/Projects/mcp-pubnub │\n╰───────────────────────────────────────────────────╯\n\n ※ Tip: Press Option+Enter to send a multi-line message\n\n> publish a message 'hi' to the 'my_channel' pubnub channel.\n\n⏺ I'll publish a message to the PubNub channel for you.\n\n⏺ pubnub:publish_pubnub_message (MCP)(channel: \"my_channel\", message: \"hi\")…\n ⎿ Message published successfully. Timetoken: 17467422499409217\n\n⏺ Message published successfully to \"my_channel\".\n```\n\n次のコマンドで MCP サーバーを削除します。\n\n```shell\nclaude mcp remove pubnub\n```\n\n## Claudeデスクトップの使用\n\nClaude Desktop の Docker ベースの MCP サーバーを希望する場合:\n\n1. PubNub キーがシェルにエクスポートされていることを確認します。\n\n ```bash\n export PUBNUB_PUBLISH_KEY=your_publish_key\n export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n ```\n\n2. Claude Desktop の**ツール**セクションで、 **pubnub**という名前の新しいツールを追加します。\n\n3. **コマンド**を`docker`に設定します。\n\n4. **引数を**次のように設定します:\n\n ```json\n [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n ```\n\n> \\*\\*注:\\*\\*一部のマシン（例：Apple Silicon）では、Dockerプラットフォームの指定が必要になる場合があります。Arguments配列の`\"run\"`の直後に`--platform linux/arm64` （または`--platform linux/amd64` ）を追加してください。例:\n>\n> ```json\n> [\n> \"run\",\n> \"--platform\", \"linux/arm64\",\n> \"-i\",\n> \"-e\", \"PUBNUB_PUBLISH_KEY\",\n> \"-e\", \"PUBNUB_SUBSCRIBE_KEY\",\n> \"pubnub/pubnub-mcp-server\"\n> ]\n> ```\n\n5. 設定を保存します。\n\nClaude Desktop は、Docker 経由で PubNub MCP サーバーコンテナーを呼び出します。\n\n## ライセンス\n\nこのプロジェクトはMITライセンスの下で提供されています。詳細は[LICENSE](LICENSE)ファイルをご覧ください。\n\n## トラブルシューティング\n\n* MCP サーバーを使用するにはエージェントモードにする必要があります。\n* Node.js と npm のインストールを確認します。\n* `index.js`に実行権限があることを確認します。\n* `command` 、 `args` 、および`env`設定が正しいことを確認します。\n* MCP 起動エラーについては、カーソル IDE ログを確認します。\n\n## JSON-RPC コマンドラインの直接使用\n\nJSON-RPC v2.0 を使用すると、STDIN/STDOUT 経由で MCP サーバーを直接呼び出すことができます。PubNub キーが環境に設定されていることを確認してください。例:\n\n```bash\nPUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \\\nPUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \\\n node index.js\n```\n\nサーバーが起動したら（または1回限りの呼び出しを使用したら）、JSONを`node index.js`にパイプしてリクエストを送信します。例:\n\n```bash\n# 1) List available tools\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' \\\n | node index.js\n\n# 2) Read PubNub JavaScript SDK documentation\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":\n {\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' \\\n | node index.js\n\n# 3) Read PubNub Functions Resource docs (static Markdown)\necho '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_resources\",\"arguments\":{\"document\":\"pubnub_functions\"}}}' \\\n | node index.js\n\n```\n\n## 簡単なJSON-RPCの例\n\n以下は、STDIN/STDOUT を使用して PubNub SDK ドキュメントを取得し、メッセージを公開する簡略化された JSON-RPC v2.0 コマンドラインの例です。\n\n### 1) PubNub JavaScript SDKドキュメントを取得する\n\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' | node index.js\n```\n\n### 2) PubNubチャネルにメッセージを公開する\n\n```bash\nPUBNUB_PUBLISH_KEY=demo \\\nPUBNUB_SUBSCRIBE_KEY=demo \\\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"publish_pubnub_message\",\"arguments\":{\"channel\":\"my_channel\",\"message\":\"Hello, PubNub MCP JSON-RPC!\"}}}' \\\n | node index.js\n```","Japanese","ja-JP",{"_27":60,"_31":64,"_36":65},{"_29":61,"_31":62,"_33":63},"PubNub SDK 설명서와 기능 리소스를 Cursor IDE와 같은 LLM 기반 도구에 노출하는 CLI 기반 모델 컨텍스트 프로토콜 서버로, 사용자가 자연어 프롬프트를 통해 설명서를 가져오고 PubNub 채널과 상호 작용할 수 있도록 합니다.","PubNub MCP 서버","![MCP 서버 로고](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-server-model-context-protocol.jpg)\n\n# 커서 IDE용 PubNub 모델 컨텍스트 프로토콜(MCP) 서버\n\n이 저장소는 PubNub SDK 문서와 PubNub API 리소스를 LLM 기반 도구에 노출하는 CLI 기반 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 이를 통해 LLM AI 에이전트가 PubNub SDK 및 API를 이해하고 상호 작용하는 능력이 향상됩니다.\n\n![PubNub MCP 사용 시 vs 미사용 시](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-vs-no-mcp.jpg)\n\n## 특징\n\n* STDIN/STDOUT을 통한 JSON-RPC를 통해 PubNub과 상호작용하기 위한 도구를 제공하는 MCP 서버입니다.\n* PubNub SDK 공식 문서(HTML → Markdown)를 ��색하세요:\n * 언어: JavaScript, Python, Java, Go, Ruby, Swift, Objective-C, C#, PHP, Rust, Unity, Kotlin, Unreal.\n * API 참조 섹션: 구성, 게시 및 구독, 상태, 액세스 관리자, 채널 그룹, 저장소 및 재생, 모바일 푸시, 객체, 파일, 메시지 작업, 기타, 함수.\n* `resources` 마크다운 파일(예: `pubnub_concepts` , `pubnub_features` , `pubnub_security` , `how_to_send_receive_json` , `how_to_encrypt_messages_files` 등)에서 PubNub 개념 가이드와 방법 문서를 가져옵니다.\n* `publish_pubnub_message` 사용하여 PubNub 채널에 메시지를 게시하고 timetoken을 반환합니다.\n* `get_pubnub_messages` 사용하여 하나 이상의 채널에서 과거 메시지를 가져와서 JSON 형식으로 메시지 내용과 메타데이터를 반환합니다.\n* `get_pubnub_presence` 사용하여 채널 및 채널 그룹의 실시간 존재 정보(점유 수, 구독자 UUID)를 검색합니다.\n* `write_pubnub_app` 사용하여 여러 언어로 PubNub SDK를 초기화하기 위한 코드 조각을 포함하여 PubNub 애플리케이션을 만드는 단계별 지침을 생성합니다.\n* 환경 변수 구성: SDK 작업 인증을 위해 `PUBNUB_PUBLISH_KEY` 및 `PUBNUB_SUBSCRIBE_KEY` 지원합니다.\n* `jsdom` 과 `turndown` 사용하여 원격 HTML 문서를 Markdown으로 변환하여 일관된 문서 형식을 유지합니다.\n* 모든 도구 매개변수에 대해 Zod 스키마를 통한 입력 검증을 통해 강력한 오류 처리를 보장합니다.\n* `McpServer` 및 `StdioServerTransport` 와 함께 Model Context Protocol SDK( `@modelcontextprotocol/sdk` )를 활용한 확장 가능한 도구 정의.\n\n## 예시 프롬프트\n\n* \"PubNub에서 다중 사용자 채팅 기능을 내장하고, 사용자가 스트리밍 비디오를 시청할 수 있는 PubNub 앱을 작성하세요.\"\n* \"지도가 포함된 주문형 식료품 배달 서비스를 제공하는 PubNub 앱을 작성하세요.\"\n* \"실시간으로 패키지의 위치를 추적하는 PubNub 앱을 작성하세요.\"\n* \"실시간으로 날씨 예보를 보여주는 PubNub 앱을 작성하세요.\"\n* \"친구와 함께 멀티플레이어 게임을 즐길 수 있는 PubNub 앱을 작성하세요.\"\n* \"실시간 주가와 뉴스 업데이트를 보여주는 PubNub 앱을 작성하세요.\"\n* \"사용자가 플레이리스트를 만들어 친구들과 공유할 수 있는 PubNub 앱을 작성하세요.\"\n* \" `my_channel` 채널을 구독하고 콘솔에 메시지를 기록하는 PubNub JavaScript 앱을 빌드하세요.\"\n* \" `Hello, PubNub!` 라는 메시지와 함께 `my_channel` 채널에 메시지를 게시하세요.\"\n* \" `subscribe()` 에 대한 PubNub JavaScript SDK 설명서를 보여주세요.\"\n* \"사용 가능한 PubNub 함수를 모두 나열하세요.\"\n* \" `publish()` 메서드에 대한 Python SDK 문서를 가져옵니다.\"\n* \" `test` 채널의 메시지 기록을 가져옵니다.\"\n* `test` 채널과 `default` 채널 그룹에 대한 상태 정보(점유 및 UUID)를 검색합니다.\n\n이 작업에는 Node.js(>= 18)와 npm( )이 필요합니다. `npx` 자동으로 최신 MCP 서버를 가져와서 실행합니다.\n\n## 필수 조건\n\n* Node.js(>= 18) 및 npm\n* MCP를 지원하는 커서 IDE\n* (선택 사항) 라이브 예제를 위한 PubNub 계정 및 API 키\n\n## 설치\n\nPubNub MCP 서버를 로컬에서 실행하거나 npx를 통해 Cursor IDE에 추가하는 가장 좋은 방법은 다음과 같습니다.\n\n지엑스피1\n\n## 구성\n\n> *MCP 서버를 사용하려면 커서가 에이전트 모드에 있어야 합니다.*\n\n커서 IDE는 JSON 구성 파일을 통해 MCP 서버를 검색합니다. PubNub MCP 서버를 전역 또는 프로젝트별로 구성하세요.\n\n### 글로벌 구성\n\n`~/.cursor/mcp.json` 편집하거나 생성합니다.\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### 프로젝트 구성\n\n프로젝트 디렉토리에 `.cursor/mcp.json` 만듭니다.\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Docker 기반 구성\n\nDocker를 통해 MCP 서버를 실행하려면 PubNub 키를 환경 변수로 설정하세요.\n\n```bash\nexport PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY\nexport PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY\n```\n\n그런 다음 `~/.cursor/mcp.json` (또는 프로젝트에서 `.cursor/mcp.json` )을 구성합니다.\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n }\n }\n}\n```\n\n* `command` MCP 서버를 시작하기 위한 실행 파일을 지정합니다.\n* `args` 명령에 전달할 인수를 지정합니다.\n* `env` 서버 프로세스에 대한 환경 변수를 설정합니다.\n\n## 커서 IDE에서 사용\n\n1. 커서 IDE를 다시 시작하거나 새로운 세션을 엽니다.\n2. MCP 설정 창을 열고 **pubnub** 서버가 **사용 가능한 도구 및 리소스** 에 나열되어 있는지 확인하세요.\n3. 채팅에서 사용 가능한 리소스를 호출합니다.\n * `pubnub://docs/javascript` — PubNub JavaScript SDK 설명서 가져오기\n * `pubnub://docs/python` — PubNub Python SDK 문서 가져오기\n * `pubnub://docs/java` — PubNub Java SDK 문서 가져오기\n * `pubnub://functions` — PubNub 함수 목록( `resources/pubnub_functions.md` 의 정적 콘텐츠)\n4. 메시지가 표시되면 리소스 실행을 승인하거나 신뢰할 수 있는 리소스에 대한 설정에서 **자동 실행을** 활성화합니다.\n\n## 클로드 코드\n\n```shell\n## Install the MCP server if you have node >= 18\nclaude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp\n\n## Install the MCP server if you have node < 18 and need to point to the full path of node\nclaude 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\n\n## Install the MCP server using Docker\n# Ensure your PubNub keys are set as environment variables:\nexport PUBNUB_PUBLISH_KEY=your_publish_key\nexport PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n\n# Depending on your machine’s CPU architecture, you may need to specify the target platform.\n# For example:\n# docker run --platform linux/arm64 -i pubnub/pubnub-mcp-server\n# docker run --platform linux/amd64 -i pubnub/pubnub-mcp-server\n\nclaude mcp add pubnub -- docker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n pubnub/pubnub-mcp-server\n```\n\n출력은 다음과 같습니다.\n\n```shell\nAdded stdio MCP server pubnub with command: npx -y @pubnub/mcp to local config\n```\n\n### 예시 프롬프트\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n```\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n\n╭───────────────────────────────────────────────────╮\n│ ✻ Welcome to Claude Code research preview! │\n│ │\n│ /help for help, /status for your current setup │\n│ │\n│ cwd: /Users/stephen/Projects/mcp-pubnub │\n╰───────────────────────────────────────────────────╯\n\n ※ Tip: Press Option+Enter to send a multi-line message\n\n> publish a message 'hi' to the 'my_channel' pubnub channel.\n\n⏺ I'll publish a message to the PubNub channel for you.\n\n⏺ pubnub:publish_pubnub_message (MCP)(channel: \"my_channel\", message: \"hi\")…\n ⎿ Message published successfully. Timetoken: 17467422499409217\n\n⏺ Message published successfully to \"my_channel\".\n```\n\n다음을 사용하여 MCP 서버를 제거합니다.\n\n```shell\nclaude mcp remove pubnub\n```\n\n## Claude Desktop 사용\n\nClaude Desktop에서 Docker 기반 MCP 서버를 선호하는 경우:\n\n1. PubNub 키가 셸로 내보내졌는지 확인하세요.\n\n ```bash\n export PUBNUB_PUBLISH_KEY=your_publish_key\n export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n ```\n\n2. Claude Desktop의 **도구** 섹션에서 **pubnub** 이라는 이름의 새 도구를 추가합니다.\n\n3. **명령을** `docker` 로 설정합니다.\n\n4. **인수** 설정:\n\n ```json\n [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n ```\n\n> **참고:** 일부 머신(예: Apple Silicon)에서는 Docker 플랫폼을 지정해야 할 수 있습니다. Arguments 배열의 `\"run\"` 바로 뒤에 `--platform linux/arm64` (또는 `--platform linux/amd64` )를 삽입하세요. 예:\n>\n> ```json\n> [\n> \"run\",\n> \"--platform\", \"linux/arm64\",\n> \"-i\",\n> \"-e\", \"PUBNUB_PUBLISH_KEY\",\n> \"-e\", \"PUBNUB_SUBSCRIBE_KEY\",\n> \"pubnub/pubnub-mcp-server\"\n> ]\n> ```\n\n5. 구성을 저장합니다.\n\nClaude Desktop은 Docker를 통해 PubNub MCP 서버 컨테이너를 호출합니다.\n\n## 특허\n\n이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 [라이선스](LICENSE) 파일을 참조하세요.\n\n## 문제 해결\n\n* MCP 서버를 사용하려면 에이전트 모드에 있어야 합니다.\n* Node.js와 npm 설치를 확인하세요.\n* `index.js` 에 실행 권한이 있는지 확인하세요.\n* `command` , `args` , `env` 설정이 올바른지 확인하세요.\n* MCP 시작 오류를 확인하려면 Cursor IDE 로그를 검토하세요.\n\n## 직접 JSON-RPC 명령줄 사용\n\nJSON-RPC v2.0을 사용하여 STDIN/STDOUT을 통해 MCP 서버를 직접 호출할 수 있습니다. PubNub 키가 환경에 설정되어 있는지 확인하세요. 예:\n\n```bash\nPUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \\\nPUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \\\n node index.js\n```\n\n서버가 실행 중이거나 일회성 호출을 사용하는 경우 JSON을 `node index.js` 로 파이프하여 요청을 보냅니다. 예:\n\n```bash\n# 1) List available tools\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' \\\n | node index.js\n\n# 2) Read PubNub JavaScript SDK documentation\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":\n {\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' \\\n | node index.js\n\n# 3) Read PubNub Functions Resource docs (static Markdown)\necho '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_resources\",\"arguments\":{\"document\":\"pubnub_functions\"}}}' \\\n | node index.js\n\n```\n\n## 빠른 JSON-RPC 예제\n\n아래는 STDIN/STDOUT을 사용하여 PubNub SDK 문서를 가져오고 메시지를 게시하는 간소화된 JSON-RPC v2.0 명령줄 예제입니다.\n\n### 1) PubNub JavaScript SDK 문서 가져오기\n\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' | node index.js\n```\n\n### 2) PubNub 채널에 메시지 게시\n\n```bash\nPUBNUB_PUBLISH_KEY=demo \\\nPUBNUB_SUBSCRIBE_KEY=demo \\\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"publish_pubnub_message\",\"arguments\":{\"channel\":\"my_channel\",\"message\":\"Hello, PubNub MCP JSON-RPC!\"}}}' \\\n | node index.js\n```","Korean","ko-KR",{"_27":67,"_31":71,"_36":72},{"_29":68,"_31":69,"_33":70},"Сервер протокола контекста модели на базе CLI, который предоставляет документацию PubNub SDK и ресурсы функций инструментам на базе LLM, таким как Cursor IDE, позволяя пользователям получать документацию и взаимодействовать с каналами PubNub с помощью подсказок на естественном языке.","MCP-сервер PubNub","![Логотип сервера MCP](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-server-model-context-protocol.jpg)\n\n# Сервер протокола контекста модели PubNub (MCP) для среды разработки курсоров\n\nЭтот репозиторий предоставляет сервер Model Context Protocol (MCP) на основе CLI, который предоставляет документацию PubNub SDK и ресурсы PubNub API для инструментов на базе LLM. Это улучшает способность агента LLM AI понимать и взаимодействовать с SDK и API PubNub.\n\n![С PubNub MCP против Без](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-vs-no-mcp.jpg)\n\n## Функции\n\n* Сервер MCP, предоставляющий инструменты для взаимодействия с PubNub посредством JSON-RPC через STDIN/STDOUT.\n* Получите официальную документацию PubNub SDK (HTML → Markdown) для:\n * Языки: JavaScript, Python, Java, Go, Ruby, Swift, Objective-C, C#, PHP, Rust, Unity, Kotlin, Unreal.\n * Разделы справки по API: конфигурация, публикация и подписка, присутствие, менеджер доступа, группы каналов, хранение и воспроизведение, мобильные push-уведомления, объекты, файлы, действия с сообщениями, разное, функции.\n* Извлеките концептуальные руководства и практическую документацию PubNub из локальных файлов разметки в каталоге `resources` (например, `pubnub_concepts` , `pubnub_features` , `pubnub_security` , `how_to_send_receive_json` , `how_to_encrypt_messages_files` и т. д.).\n* Публикуйте сообщения в каналах PubNub с помощью `publish_pubnub_message` , возвращая временной токен.\n* Извлекайте исторические сообщения из одного или нескольких каналов с помощью `get_pubnub_messages` , возвращая содержимое сообщения и метаданные в формате JSON.\n* Получайте информацию о присутствии в реальном времени (количество пользователей, UUID подписчиков) для каналов и групп каналов с помощью `get_pubnub_presence` .\n* Создайте пошаговые инструкции по созданию приложения PubNub, включая фрагменты кода для инициализации PubNub SDK на нескольких языках с помощью `write_pubnub_app` .\n* Конфигурация переменных среды: поддерживает `PUBNUB_PUBLISH_KEY` и `PUBNUB_SUBSCRIBE_KEY` для аутентификации операций SDK.\n* Конвертирует удаленные статьи HTML в Markdown с использованием `jsdom` и `turndown` для единообразного форматирования документации.\n* Проверка входных данных с помощью схем Zod для всех параметров инструмента, обеспечивающая надежную обработку ошибок.\n* Расширяемые определения инструментов, использующие SDK Model Context Protocol ( `@modelcontextprotocol/sdk` ) с `McpServer` и `StdioServerTransport` .\n\n## Примеры подсказок\n\n* «Напишите приложение PubNub, которое позволит пользователю смотреть потоковое видео с помощью встроенного многопользовательского чата с PubNub».\n* «Напишите приложение PubNub для доставки продуктов по запросу с картой».\n* «Напишите приложение PubNub, которое отслеживает местонахождение посылки в режиме реального времени».\n* «Напишите приложение PubNub, которое показывает прогноз погоды в режиме реального времени».\n* «Напишите приложение PubNub, которое позволит пользователям играть в многопользовательские игры с друзьями».\n* «Напишите приложение PubNub, которое будет показывать актуальные цены акций и новости».\n* «Напишите приложение PubNub, которое позволит пользователям создавать плейлисты и делиться ими с друзьями».\n* «Создайте приложение PubNub JavaScript, которое подписывается на канал `my_channel` и записывает сообщения в консоль».\n* «Опубликуйте сообщение на канале `my_channel` с текстом `Hello, PubNub!` ».\n* «Покажите мне документацию PubNub JavaScript SDK для `subscribe()` ».\n* «Перечислить все доступные функции PubNub».\n* «Извлеките документацию Python SDK для метода `publish()` ».\n* «Извлеките историю сообщений для `test` канала».\n* «Получить информацию о присутствии (занятость и UUID) для `test` канала и группы каналов `default` ».\n\nДля этого требуются Node.js (>= 18) и npm ( ). `npx` автоматически загрузит и запустит последнюю версию сервера MCP.\n\n## Предпосылки\n\n* Node.js (>= 18) и npm\n* Курсор IDE с поддержкой MCP\n* (Необязательно) Учетная запись PubNub и ключи API для живых примеров\n\n## Установка\n\nПредпочтительный способ запустить сервер PubNub MCP локально или добавить его в Cursor IDE через npx:\n\n```bash\nnpx -y @pubnub/mcp\n```\n\n## Конфигурация\n\n> *Для использования серверов MCP курсор должен находиться в РЕЖИМЕ АГЕНТА.*\n\nCursor IDE обнаруживает серверы MCP через файл конфигурации JSON. Настройте сервер PubNub MCP глобально или для каждого проекта.\n\n### Глобальная конфигурация\n\nОтредактируйте или создайте `~/.cursor/mcp.json` :\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Конфигурация проекта\n\nВ каталоге вашего проекта создайте `.cursor/mcp.json` :\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Конфигурация на основе Docker\n\nЕсли вы предпочитаете запускать сервер MCP через Docker, установите ключи PubNub в качестве переменных среды:\n\n```bash\nexport PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY\nexport PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY\n```\n\nЗатем настройте ваш `~/.cursor/mcp.json` (или `.cursor/mcp.json` в вашем проекте):\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n }\n }\n}\n```\n\n* `command` указывает исполняемый файл для запуска сервера MCP.\n* `args` указывает аргументы, передаваемые команде.\n* `env` устанавливает переменные среды для серверного процесса.\n\n## Использование в Cursor IDE\n\n1. Перезапустите Cursor IDE или откройте новый сеанс.\n2. Откройте панель настроек MCP и убедитесь, что сервер **pubnub** указан в разделе **«Доступные инструменты и ресурсы»** .\n3. В чате вызовите доступные ресурсы:\n * `pubnub://docs/javascript` — Получить документацию PubNub JavaScript SDK\n * `pubnub://docs/python` — Получить документацию PubNub Python SDK\n * `pubnub://docs/java` — Получить документацию PubNub Java SDK\n * `pubnub://functions` — Список функций PubNub (статический контент из `resources/pubnub_functions.md` )\n4. При появлении соответствующего запроса одобрите выполнение ресурсов или включите **автоматический запуск** в настройках для доверенных ресурсов.\n\n## Клод Код\n\n```shell\n## Install the MCP server if you have node >= 18\nclaude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp\n\n## Install the MCP server if you have node < 18 and need to point to the full path of node\nclaude 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\n\n## Install the MCP server using Docker\n# Ensure your PubNub keys are set as environment variables:\nexport PUBNUB_PUBLISH_KEY=your_publish_key\nexport PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n\n# Depending on your machine’s CPU architecture, you may need to specify the target platform.\n# For example:\n# docker run --platform linux/arm64 -i pubnub/pubnub-mcp-server\n# docker run --platform linux/amd64 -i pubnub/pubnub-mcp-server\n\nclaude mcp add pubnub -- docker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n pubnub/pubnub-mcp-server\n```\n\nИ вывод будет таким:\n\n```shell\nAdded stdio MCP server pubnub with command: npx -y @pubnub/mcp to local config\n```\n\n### Пример подсказки\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n```\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n\n╭───────────────────────────────────────────────────╮\n│ ✻ Welcome to Claude Code research preview! │\n│ │\n│ /help for help, /status for your current setup │\n│ │\n│ cwd: /Users/stephen/Projects/mcp-pubnub │\n╰───────────────────────────────────────────────────╯\n\n ※ Tip: Press Option+Enter to send a multi-line message\n\n> publish a message 'hi' to the 'my_channel' pubnub channel.\n\n⏺ I'll publish a message to the PubNub channel for you.\n\n⏺ pubnub:publish_pubnub_message (MCP)(channel: \"my_channel\", message: \"hi\")…\n ⎿ Message published successfully. Timetoken: 17467422499409217\n\n⏺ Message published successfully to \"my_channel\".\n```\n\nУдалите сервер MCP с помощью:\n\n```shell\nclaude mcp remove pubnub\n```\n\n## Использование Claude Desktop\n\nЕсли вы предпочитаете сервер MCP на базе Docker в Claude Desktop:\n\n1. Убедитесь, что ваши ключи PubNub экспортированы в вашу оболочку:\n\n ```bash\n export PUBNUB_PUBLISH_KEY=your_publish_key\n export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n ```\n\n2. В разделе **«Инструменты»** Claude Desktop добавьте новый инструмент с именем **pubnub** .\n\n3. Установите **команду** `docker` .\n\n4. Установите **аргументы** на:\n\n ```json\n [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n ```\n\n> **Примечание:** На некоторых машинах (например, Apple Silicon) может потребоваться указать платформу Docker. Вставьте `--platform linux/arm64` (или `--platform linux/amd64` ) сразу после `\"run\"` в массиве Arguments. Например:\n>\n> ```json\n> [\n> \"run\",\n> \"--platform\", \"linux/arm64\",\n> \"-i\",\n> \"-e\", \"PUBNUB_PUBLISH_KEY\",\n> \"-e\", \"PUBNUB_SUBSCRIBE_KEY\",\n> \"pubnub/pubnub-mcp-server\"\n> ]\n> ```\n\n5. Сохраните конфигурацию.\n\nClaude Desktop вызовет контейнер сервера PubNub MCP через Docker.\n\n## Лицензия\n\nЭтот проект лицензирован по лицензии MIT. Подробности см. в файле [LICENSE](LICENSE) .\n\n## Поиск неисправностей\n\n* Для использования серверов MCP необходимо находиться в режиме агента.\n* Проверьте установку Node.js и npm.\n* Убедитесь, что у `index.js` есть разрешение на выполнение.\n* Проверьте правильность настроек `command` , `args` и `env` .\n* Проверьте журналы Cursor IDE на наличие ошибок запуска MCP.\n\n## Прямое использование командной строки JSON-RPC\n\nВы можете вызвать сервер MCP напрямую через STDIN/STDOUT с помощью JSON-RPC v2.0. Убедитесь, что ваши ключи PubNub установлены в среде, например:\n\n```bash\nPUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \\\nPUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \\\n node index.js\n```\n\nПосле запуска сервера (или использования одноразового вызова) отправьте запросы, передав JSON в `node index.js` . Примеры:\n\n```bash\n# 1) List available tools\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' \\\n | node index.js\n\n# 2) Read PubNub JavaScript SDK documentation\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":\n {\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' \\\n | node index.js\n\n# 3) Read PubNub Functions Resource docs (static Markdown)\necho '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_resources\",\"arguments\":{\"document\":\"pubnub_functions\"}}}' \\\n | node index.js\n\n```\n\n## Краткие примеры JSON-RPC\n\nНиже приведены упрощенные примеры командной строки JSON-RPC v2.0 с использованием STDIN/STDOUT для получения документации PubNub SDK и публикации сообщений.\n\n### 1) Получите документацию PubNub JavaScript SDK\n\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' | node index.js\n```\n\n### 2) Опубликуйте сообщение на канале PubNub\n\n```bash\nPUBNUB_PUBLISH_KEY=demo \\\nPUBNUB_SUBSCRIBE_KEY=demo \\\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"publish_pubnub_message\",\"arguments\":{\"channel\":\"my_channel\",\"message\":\"Hello, PubNub MCP JSON-RPC!\"}}}' \\\n | node index.js\n```","Russian","ru-RU",{"_27":74,"_31":78,"_36":79},{"_29":75,"_31":76,"_33":77},"基于 CLI 的模型上下文协议服务器，将 PubNub SDK 文档和函数资源公开给 Cursor IDE 等 LLM 驱动的工具，使用户能够获取文档并通过自然语言提示与 PubNub 频道进行交互。","PubNub MCP 服务器","![MCP 服务器徽标](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-server-model-context-protocol.jpg)\n\n# 用于 Cursor IDE 的 PubNub 模型上下文协议 (MCP) 服务器\n\n此存储库提供了一个基于 CLI 的模型上下文协议 (MCP) 服务器，该服务器将 PubNub SDK 文档和 PubNub API 资源公开给 LLM 驱动的工具。这提高了 LLM AI 代理理解和与 PubNub SDK 和 API 交互的能力。\n\n![使用 PubNub MCP 与不使用 PubNub MCP 的对比](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-vs-no-mcp.jpg)\n\n## 特征\n\n* MCP 服务器公开了通过 STDIN/STDOUT 上的 JSON-RPC 与 PubNub 交互的工具。\n* 检索官方 PubNub SDK 文档（HTML → Markdown）：\n * 语言：JavaScript、Python、Java、Go、Ruby、Swift、Objective-C、C#、PHP、Rust、Unity、Kotlin、Unreal。\n * API 参考部分：配置、发布和订阅、存在、访问管理器、频道组、存储和回放、移动推送、对象、文件、消息操作、杂项、功能。\n* 从`resources`目录中的本地 markdown 文件获取 PubNub 概念指南和操作方法文档（例如， `pubnub_concepts` 、 `pubnub_features` 、 `pubnub_security` 、 `how_to_send_receive_json` 、 `how_to_encrypt_messages_files`等）。\n* 使用`publish_pubnub_message`将消息发布到 PubNub 频道，并返回一个时间标记。\n* 使用`get_pubnub_messages`从一个或多个频道获取历史消息，并以 JSON 格式返回消息内容和元数据。\n* 使用`get_pubnub_presence`检索频道和频道组的实时存在信息（占用人数、订阅者 UUID）。\n* 生成创建 PubNub 应用程序的分步说明，包括使用`write_pubnub_app`以多种语言初始化 PubNub SDK 的代码片段。\n* 环境变量配置：支持`PUBNUB_PUBLISH_KEY`和`PUBNUB_SUBSCRIBE_KEY`用于验证SDK操作。\n* 使用`jsdom`和`turndown`将远程 HTML 文章转换为 Markdown，以实现一致的文档格式。\n* 通过 Zod 模式对所有工具参数进行输入验证，确保强大的错误处理能力。\n* 利用模型上下文协议 SDK（ `@modelcontextprotocol/sdk` ）与`McpServer`和`StdioServerTransport`可扩展工具定义。\n\n## 示例提示\n\n* “编写一个 PubNub 应用程序，让用户可以通过 PubNub 内置的多用户聊天观看流媒体视频。”\n* “编写一个 PubNub 应用程序，通过地图按需配送杂货。”\n* “编写一个 PubNub 应用程序来实时跟踪包裹的位置。”\n* “编写一个 PubNub 应用程序，实时显示天气预报。”\n* “编写一个 PubNub 应用程序，让用户与朋友一起玩多人游戏。”\n* “编写一个 PubNub 应用程序，显示实时股票价格和新闻更新。”\n* “编写一个 PubNub 应用程序，让用户创建并与朋友分享播放列表。”\n* “构建一个 PubNub JavaScript 应用程序，订阅`my_channel`频道并将消息记录到控制台。”\n* “向`my_channel`频道发布一条消息，内容为`Hello, PubNub!` 。”\n* “向我展示`subscribe()`的 PubNub JavaScript SDK 文档。”\n* “列出所有可用的 PubNub 函数。”\n* “获取`publish()`方法的 Python SDK 文档。”\n* “获取`test`频道的消息历史记录。”\n* “ `test`频道和`default`频道组的存在信息（占用率和 UUID）。”\n\n这需要 Node.js (>= 18) 和 npm ( ) `npx`将自动获取并运行最新的 MCP 服务器。\n\n## 先决条件\n\n* Node.js（>= 18）和 npm\n* 带有 MCP 支持的 Cursor IDE\n* （可选）用于现场示例的 PubNub 帐户和 API 密钥\n\n## 安装\n\n在本地运行 PubNub MCP 服务器或通过 npx 将其添加到 Cursor IDE 的首选方法：\n\n```bash\nnpx -y @pubnub/mcp\n```\n\n## 配置\n\n> *光标必须处于代理模式才能使用 MCP 服务器。*\n\nCursor IDE 通过 JSON 配置文件发现 MCP 服务器。您可以全局或按项目配置 PubNub MCP 服务器。\n\n### 全局配置\n\n编辑或创建`~/.cursor/mcp.json` ：\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### 项目配置\n\n在您的项目目录中，创建`.cursor/mcp.json` ：\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### 基于 Docker 的配置\n\n如果您希望通过 Docker 运行 MCP 服务器，请将您的 PubNub 密钥设置为环境变量：\n\n```bash\nexport PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY\nexport PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY\n```\n\n然后配置你的`~/.cursor/mcp.json` (或者你项目中的`.cursor/mcp.json` )：\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n }\n }\n}\n```\n\n* `command`指定启动 MCP 服务器的可执行文件。\n* `args`指定传递给命令的参数。\n* `env`为服务器进程设置环境变量。\n\n## 在 Cursor IDE 中使用\n\n1. 重新启动 Cursor IDE 或打开一个新会话。\n2. 打开 MCP 设置窗格并验证**pubnub**服务器是否列在**可用工具和资源**下。\n3. 在聊天中，调用可用资源：\n * `pubnub://docs/javascript` — 获取 PubNub JavaScript SDK 文档\n * `pubnub://docs/python` — 获取 PubNub Python SDK 文档\n * `pubnub://docs/java` — 获取 PubNub Java SDK 文档\n * `pubnub://functions` — 列出 PubNub 函数（来自`resources/pubnub_functions.md`静态内容）\n4. 在出现提示时批准资源执行，或在受信任资源的设置中启用**自动运行**。\n\n## 克劳德·科德\n\n```shell\n## Install the MCP server if you have node >= 18\nclaude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp\n\n## Install the MCP server if you have node < 18 and need to point to the full path of node\nclaude 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\n\n## Install the MCP server using Docker\n# Ensure your PubNub keys are set as environment variables:\nexport PUBNUB_PUBLISH_KEY=your_publish_key\nexport PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n\n# Depending on your machine’s CPU architecture, you may need to specify the target platform.\n# For example:\n# docker run --platform linux/arm64 -i pubnub/pubnub-mcp-server\n# docker run --platform linux/amd64 -i pubnub/pubnub-mcp-server\n\nclaude mcp add pubnub -- docker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n pubnub/pubnub-mcp-server\n```\n\n输出将是：\n\n```shell\nAdded stdio MCP server pubnub with command: npx -y @pubnub/mcp to local config\n```\n\n### 示例提示\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n```\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n\n╭───────────────────────────────────────────────────╮\n│ ✻ Welcome to Claude Code research preview! │\n│ │\n│ /help for help, /status for your current setup │\n│ │\n│ cwd: /Users/stephen/Projects/mcp-pubnub │\n╰───────────────────────────────────────────────────╯\n\n ※ Tip: Press Option+Enter to send a multi-line message\n\n> publish a message 'hi' to the 'my_channel' pubnub channel.\n\n⏺ I'll publish a message to the PubNub channel for you.\n\n⏺ pubnub:publish_pubnub_message (MCP)(channel: \"my_channel\", message: \"hi\")…\n ⎿ Message published successfully. Timetoken: 17467422499409217\n\n⏺ Message published successfully to \"my_channel\".\n```\n\n使用以下命令删除 MCP 服务器：\n\n```shell\nclaude mcp remove pubnub\n```\n\n## 使用 Claude Desktop\n\n如果您更喜欢 Claude Desktop 中基于 Docker 的 MCP 服务器：\n\n1. 确保您的 PubNub 密钥已导出到您的 shell 中：\n\n ```bash\n export PUBNUB_PUBLISH_KEY=your_publish_key\n export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n ```\n\n2. 在 Claude Desktop 的**工具**部分，添加一个名为**pubnub**的新工具。\n\n3. 将**命令**设置为`docker` 。\n\n4. 将**参数**设置为：\n\n ```json\n [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n ```\n\n> \\*\\*注意：\\*\\*在某些机器上（例如 Apple Silicon），您可能需要指定 Docker 平台。请在 Arguments 数组中的`\"run\"`后立即插入`--platform linux/arm64` （或`--platform linux/amd64` ）。例如：\n>\n> ```json\n> [\n> \"run\",\n> \"--platform\", \"linux/arm64\",\n> \"-i\",\n> \"-e\", \"PUBNUB_PUBLISH_KEY\",\n> \"-e\", \"PUBNUB_SUBSCRIBE_KEY\",\n> \"pubnub/pubnub-mcp-server\"\n> ]\n> ```\n\n5. 保存配置。\n\nClaude Desktop 将通过 Docker 调用 PubNub MCP 服务器容器。\n\n## 执照\n\n本项目遵循 MIT 许可证。详情请参阅[LICENSE](LICENSE)文件。\n\n## 故障排除\n\n* 必须处于代理模式才能使用 MCP 服务器。\n* 验证 Node.js 和 npm 安装。\n* 确保`index.js`具有执行权限。\n* 检查`command` 、 `args`和`env`设置是否正确。\n* 查看 Cursor IDE 日志以查找 MCP 启动错误。\n\n## 直接 JSON-RPC 命令行用法\n\n您可以使用 JSON-RPC v2.0 直接通过 STDIN/STDOUT 调用 MCP 服务器。请确保您的 PubNub 密钥已在环境中设置，例如：\n\n```bash\nPUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \\\nPUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \\\n node index.js\n```\n\n服务器运行后（或使用一次性调用），通过将 JSON 管道传输到`node index.js`来发送请求。示例：\n\n```bash\n# 1) List available tools\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' \\\n | node index.js\n\n# 2) Read PubNub JavaScript SDK documentation\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":\n {\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' \\\n | node index.js\n\n# 3) Read PubNub Functions Resource docs (static Markdown)\necho '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_resources\",\"arguments\":{\"document\":\"pubnub_functions\"}}}' \\\n | node index.js\n\n```\n\n## 快速 JSON-RPC 示例\n\n以下是使用 STDIN/STDOUT 获取 PubNub SDK 文档并发布消息的简化 JSON-RPC v2.0 命令行示例。\n\n### 1）获取 PubNub JavaScript SDK 文档\n\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' | node index.js\n```\n\n### 2）向 PubNub 频道发布消息\n\n```bash\nPUBNUB_PUBLISH_KEY=demo \\\nPUBNUB_SUBSCRIBE_KEY=demo \\\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"publish_pubnub_message\",\"arguments\":{\"channel\":\"my_channel\",\"message\":\"Hello, PubNub MCP JSON-RPC!\"}}}' \\\n | node index.js\n```","Chinese","zh-CN","githubUser","locale",{"_83":84,"_13":85,"_95":40,"_96":40,"_16":97,"_98":99,"_31":41,"_125":126,"_133":-5,"_134":135,"_191":192,"_197":-5,"_106":172,"_198":199,"_109":200,"_201":202},"addedAt","2025-05-10T15:00:43.336911Z",[86,87,88,89,90,91,92,93,94],"category:documentation-access","category:developer-tools","category:communication","environment:network","hosting:remote-capable","language:javascript","security_grade:a","quality_grade:a","license_grade:a","descriptionMarkdown","descriptionPlainText",6511,"integrations",[100,111,118],{"_101":102,"_29":108,"_109":110},"brand",{"_103":104,"_31":105,"_106":107},"logoSvgPath","M0 0h24v24H0V0zm22.034 18.276c-.175-1.095-.888-2.015-3.003-2.873-.736-.345-1.554-.585-1.797-1.14-.091-.33-.105-.51-.046-.705.15-.646.915-.84 1.515-.66.39.12.75.42.976.9 1.034-.676 1.034-.676 1.755-1.125-.27-.42-.404-.601-.586-.78-.63-.705-1.469-1.065-2.834-1.034l-.705.089c-.676.165-1.32.525-1.71 1.005-1.14 1.291-.811 3.541.569 4.471 1.365 1.02 3.361 1.244 3.616 2.205.24 1.17-.87 1.545-1.966 1.41-.811-.18-1.26-.586-1.755-1.336l-1.83 1.051c.21.48.45.689.81 1.109 1.74 1.756 6.09 1.666 6.871-1.004.029-.09.24-.705.074-1.65l.046.067zm-8.983-7.245h-2.248c0 1.938-.009 3.864-.009 5.805 0 1.232.063 2.363-.138 2.711-.33.689-1.18.601-1.566.48-.396-.196-.597-.466-.83-.855-.063-.105-.11-.196-.127-.196l-1.825 1.125c.305.63.75 1.172 1.324 1.517.855.51 2.004.675 3.207.405.783-.226 1.458-.691 1.811-1.411.51-.93.402-2.07.397-3.346.012-2.054 0-4.109 0-6.179l.004-.056z","JavaScript","slug","javascript","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.","uid","2hj176j8e8",{"_101":112,"_29":116,"_109":117},{"_103":113,"_31":114,"_106":115},"M11.998,24c-0.321,0-0.641-0.084-0.922-0.247l-2.936-1.737c-0.438-0.245-0.224-0.332-0.08-0.383 c0.585-0.203,0.703-0.25,1.328-0.604c0.065-0.037,0.151-0.023,0.218,0.017l2.256,1.339c0.082,0.045,0.197,0.045,0.272,0l8.795-5.076 c0.082-0.047,0.134-0.141,0.134-0.238V6.921c0-0.099-0.053-0.192-0.137-0.242l-8.791-5.072c-0.081-0.047-0.189-0.047-0.271,0 L3.075,6.68C2.99,6.729,2.936,6.825,2.936,6.921v10.15c0,0.097,0.054,0.189,0.139,0.235l2.409,1.392 c1.307,0.654,2.108-0.116,2.108-0.89V7.787c0-0.142,0.114-0.253,0.256-0.253h1.115c0.139,0,0.255,0.112,0.255,0.253v10.021 c0,1.745-0.95,2.745-2.604,2.745c-0.508,0-0.909,0-2.026-0.551L2.28,18.675c-0.57-0.329-0.922-0.945-0.922-1.604V6.921 c0-0.659,0.353-1.275,0.922-1.603l8.795-5.082c0.557-0.315,1.296-0.315,1.848,0l8.794,5.082c0.57,0.329,0.924,0.944,0.924,1.603 v10.15c0,0.659-0.354,1.273-0.924,1.604l-8.794,5.078C12.643,23.916,12.324,24,11.998,24z M19.099,13.993 c0-1.9-1.284-2.406-3.987-2.763c-2.731-0.361-3.009-0.548-3.009-1.187c0-0.528,0.235-1.233,2.258-1.233 c1.807,0,2.473,0.389,2.747,1.607c0.024,0.115,0.129,0.199,0.247,0.199h1.141c0.071,0,0.138-0.031,0.186-0.081 c0.048-0.054,0.074-0.123,0.067-0.196c-0.177-2.098-1.571-3.076-4.388-3.076c-2.508,0-4.004,1.058-4.004,2.833 c0,1.925,1.488,2.457,3.895,2.695c2.88,0.282,3.103,0.703,3.103,1.269c0,0.983-0.789,1.402-2.642,1.402 c-2.327,0-2.839-0.584-3.011-1.742c-0.02-0.124-0.126-0.215-0.253-0.215h-1.137c-0.141,0-0.254,0.112-0.254,0.253 c0,1.482,0.806,3.248,4.655,3.248C17.501,17.007,19.099,15.91,19.099,13.993z","Node.js","node-dot-js","Supports PubNub functionality through Node.js, allowing users to publish messages to channels, subscribe to channels, fetch message history, and retrieve presence information.","lxdc3pkr1g",{"_101":119,"_29":123,"_109":124},{"_103":120,"_31":121,"_106":122},"M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z","Python","python","Offers access to PubNub's Python SDK documentation, enabling users to fetch docs for methods like publish() directly through Cursor IDE.","9cbdbqfny4","namespace",{"_127":128,"_106":132},"owner",{"_129":130},"githubAccount",{"_131":132},"login","pubnub","redditPostExternalId","repository",{"_136":137,"_157":158,"_162":163,"_182":-5,"_183":184,"_185":186,"_190":-5},"argumentsJsonSchema",{"_138":139,"_154":155,"_143":156},"properties",{"_140":141,"_145":146,"_148":149,"_151":152},"HTTP_PORT",{"_29":142,"_143":144},"Port number to enable Server-Sent Events (SSE) HTTP transport mode","type","string","PUBNUB_PUBLISH_KEY",{"_29":147,"_143":144},"Your PubNub publish key (required for publishing messages)","PUBNUB_SUBSCRIBE_KEY",{"_29":150,"_143":144},"Your PubNub subscribe key (required for subscribing and message history)","MCP_SUBSCRIBE_ANALYTICS_DISABLED",{"_29":153,"_143":144},"Set to 'true' to disable the PubNub server analytics subscription","required",[],"object","githubProject",{"_33":159,"_160":161},"![MCP Server Logo](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-server-model-context-protocol.jpg)\n\n[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/f3c1be4a-2414-4af8-8e43-baf376df2d0d)\n\n[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/pubnub-pubnub-mcp-server-badge.png)](https://mseep.ai/app/pubnub-pubnub-mcp-server)\n\n\n# PubNub Model Context Protocol (MCP) Server for Cursor IDE\n\nThis repository provides a CLI-based Model Context Protocol (MCP) server that exposes PubNub SDK documentation and PubNub API resources to LLM-powered tools.\nThis improves the LLM AI Agent's ability to understand and interact with PubNub's SDKs and APIs.\n\n![With PubNub MCP vs Without](https://github.com/pubnub/pubnub-mcp-server/raw/main/context/pubnub-mcp-vs-no-mcp.jpg)\n\n## Features\n\n- MCP server exposing tools for interacting with PubNub via JSON-RPC over STDIN/STDOUT.\n- MCP server supports SSE Mode by supplying `HTTP_PORT` environment variable.\n- Retrieve official PubNub SDK documentation (HTML → Markdown) for:\n - Languages: JavaScript, Python, Java, Go, Ruby, Swift, Objective-C, C#, PHP, Rust, Unity, Kotlin, Unreal.\n - API reference sections: configuration, publish-and-subscribe, presence, access-manager, channel-groups, storage-and-playback, mobile-push, objects, files, message-actions, misc, functions.\n- Retrieve official PubNub Chat SDK documentation (HTML → Markdown) for:\n - Chat SDK languages: JavaScript, Kotlin, Swift, Unity, Unreal.\n - Chat SDK topics: configuration, chat, channel, user, message, membership, thread-channel, thread-message, message-draft, event, access-control, glossary.\n- Fetch PubNub conceptual guides and how-to documentation from local markdown files in the `resources` directory (e.g., `pubnub_concepts`, `pubnub_features`, `pubnub_security`, `how_to_send_receive_json`, `how_to_encrypt_messages_files`, etc.).\n- Publish messages to PubNub channels with `publish_pubnub_message`, returning a timetoken.\n- Subscribe to channels and receive real-time messages with `pubnub_subscribe_and_receive_messages`, supporting single or multiple message collection with optional timeout.\n- Fetch historical messages from one or more channels with `get_pubnub_messages`, returning message content and metadata in JSON.\n- Retrieve real-time presence information (occupancy counts, subscriber UUIDs) for channels and channel groups with `get_pubnub_presence`.\n- Generate step-by-step instructions for creating a PubNub application, including code snippets for initializing the PubNub SDK in multiple languages using `write_pubnub_app`.\n- Manage PubNub account apps and API keys with `manage_pubnub_account`, supporting create, list, and delete operations for both apps and API keys.\n- Environment variable configuration: supports `PUBNUB_PUBLISH_KEY` and `PUBNUB_SUBSCRIBE_KEY` for authenticating SDK operations.\n- Converts remote HTML articles to Markdown using `jsdom` and `turndown` for consistent documentation formatting.\n- Input validation via Zod schemas for all tool parameters, ensuring robust error handling.\n- Extensible tool definitions leveraging the Model Context Protocol SDK (`@modelcontextprotocol/sdk`) with `McpServer` and `StdioServerTransport`.\n\n\n $\"PubNub$ \n\n\n## Example Prompts\n\n- \"Write a PubNub app that lets the user watch streaming videos with built-in multi-user chat with PubNub.\"\n- \"Write a PubNub app for on-demand delivery of groceries with a map.\"\n- \"Write a PubNub app that tracks the location of a package in real-time.\"\n- \"Write a PubNub app that shows the weather forecast in real-time.\"\n- \"Write a PubNub app that lets users play multiplayer games with friends.\"\n- \"Write a PubNub app that shows live stock prices and news updates.\"\n- \"Write a PubNub app that lets users create and share playlists with friends.\"\n- \"Build a PubNub JavaScript app that subscribes to the `my_channel` channel and logs messages to the console.\"\n- \"Publish a message to the `my_channel` channel with the message `Hello, PubNub!`.\"\n- \"Subscribe to the `my_channel` channel and wait for one message.\"\n- \"Subscribe to the `notifications` channel and collect 5 messages with a 30-second timeout.\"\n- \"Listen for messages on the `alerts` channel for 10 seconds.\"\n- \"Show me the PubNub JavaScript SDK documentation for `subscribe()`.\"\n- \"List all available PubNub Functions.\"\n- \"Fetch the Python SDK docs for the `publish()` method.\"\n- \"Fetch the message history for the `test` channel.\"\n- \"Retrieve presence information (occupancy and UUIDs) for the `test` channel and the `default` channel group.\"\n- \"List all my PubNub apps.\"\n- \"List all API keys across my PubNub account.\"\n- \"Create a new PubNub app.\"\n- \"Create a new API key in my PubNub account.\"\n- \"Delete test apps from my PubNub account.\"\n- \"Delete test API keys from my PubNub account.\"\n\nThis requires Node.js (>= 18) and npm (https://nodejs.org/).\n`npx` will automatically fetch and run the latest MCP server.\n\n## Prerequisites\n\n- Node.js (>= 18) and npm\n- Cursor IDE with MCP support\n- (Optional) PubNub account and API keys for live examples\n\n## Installation\n\nThe preferred way to run the PubNub MCP server locally or add it to Cursor IDE via npx:\n\n```bash\nnpx -y @pubnub/mcp\n```\n\n## Configuration\n\n> *Cursor must be in AGENT MODE to use MCP servers.*\n\nCursor IDE discovers MCP servers via a JSON config file.\nConfigure the PubNub MCP server globally or per project.\n\n### Global Configuration\n\nEdit or create `~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Project Configuration\n\nIn your project directory, create `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n### Environment Variables\n\nThe PubNub MCP server supports the following environment variables:\n\n- `PUBNUB_PUBLISH_KEY`: Your PubNub publish key (required for publishing messages)\n- `PUBNUB_SUBSCRIBE_KEY`: Your PubNub subscribe key (required for subscribing and message history)\n\n### Docker-Based Configuration\n\nIf you prefer to run the MCP server via Docker, set your PubNub keys as environment variables:\n\n```bash\nexport PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY\nexport PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY\n```\n\nThen configure your `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project):\n\n```json\n{\n \"mcpServers\": {\n \"pubnub\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n }\n }\n}\n```\n\n- `command` specifies the executable to launch the MCP server.\n- `args` specifies the arguments to pass to the command.\n- `env` sets environment variables for the server process.\n\n## SSE Mode\n\nTo enable Server-Sent Events (SSE) HTTP transport, export the HTTP_PORT environment variable and start the MCP server. Ensure your PubNub API keys are set in the environment:\n\n```bash\nexport PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY\nexport PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY\nexport HTTP_PORT=3000\n```\n\n### Using NPX\n\n```bash\n# Start the MCP server in SSE mode on port 3000 with NPX\nnpx -y @pubnub/mcp\n```\n\n### Using Docker\n\n```bash\n# Start the MCP server in SSE mode on port 3000 with Docker\ndocker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n -e HTTP_PORT=$HTTP_PORT \\\n pubnub/pubnub-mcp-server\n```\n\n## Chat SDK Mode\n\nThe PubNub MCP server supports a specialized **Chat SDK Mode** that focuses exclusively on PubNub Chat SDK documentation and functionality. When enabled with the `--chat-sdk` flag, the server provides streamlined access to Chat SDK resources while excluding general PubNub SDK tools.\n\n### Key Features\n\n- **Focused Chat SDK Documentation**: Access official PubNub Chat SDK docs for JavaScript, Kotlin, Swift, Unity, and Unreal\n- **Chat-Specific Topics**: Configuration, chat, channel, user, message, membership, thread-channel, thread-message, message-draft, event, access-control, and glossary\n- **Streamlined Tool Set**: Excludes general PubNub tools to reduce complexity and focus on Chat SDK functionality\n- **Same Real-Time Capabilities**: Retains message publishing, subscription, history, and presence tools\n\n### Usage\n\n#### Command Line\n```bash\n# Enable Chat SDK mode with NPX\nnpx -y @pubnub/mcp --chat-sdk\n\n# Enable Chat SDK mode with Node.js directly\nnode index.js --chat-sdk\n```\n\n#### Cursor IDE Configuration\n\n**Global Configuration** (`~/.cursor/mcp.json`):\n```json\n{\n \"mcpServers\": {\n \"pubnub-chat\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\", \"--chat-sdk\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n**Project Configuration** (`.cursor/mcp.json`):\n```json\n{\n \"mcpServers\": {\n \"pubnub-chat\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\", \"--chat-sdk\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n#### Claude Code Integration\n```bash\n# Install Chat SDK mode MCP server\nclaude mcp add --scope user pubnub-chat -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp --chat-sdk\n```\n\n#### Docker Usage\n```bash\n# Set environment variables\nexport PUBNUB_PUBLISH_KEY=your_publish_key\nexport PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n\n# Run with Docker in Chat SDK mode\ndocker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n pubnub/pubnub-mcp-server --chat-sdk\n```\n\n### Available Tools in Chat SDK Mode\n\n**Included Tools:**\n- `read_pubnub_chat_sdk_docs` - Access Chat SDK documentation for specific languages and topics\n- `publish_pubnub_message` - Publish messages to PubNub channels\n- `get_pubnub_messages` - Fetch historical messages from channels\n- `get_pubnub_presence` - Retrieve real-time presence information\n- `pubnub_subscribe_and_receive_messages` - Subscribe and receive real-time messages\n\n**Excluded Tools:**\n- `read_pubnub_sdk_docs` - General PubNub SDK documentation\n- `write_pubnub_app` - PubNub app templates and setup instructions\n- `read_pubnub_resources` - General PubNub conceptual guides\n- `manage_pubnub_account` - PubNub account management\n\n### Example Chat SDK Prompts\n\n- \"Show me the JavaScript Chat SDK documentation for user management\"\n- \"Get the Swift Chat SDK configuration documentation\"\n- \"How do I implement threaded messaging with the Kotlin Chat SDK?\"\n- \"Show me the Unity Chat SDK documentation for message handling\"\n- \"Explain channel management in the Unreal Chat SDK\"\n- \"Get Chat SDK documentation for implementing access control\"\n- \"Show me how to handle message drafts in the JavaScript Chat SDK\"\n- \"What are the membership features available in the Chat SDK?\"\n\n## Using in Cursor IDE\n\n1. Restart Cursor IDE or open a new session.\n2. Open the MCP settings pane and verify the **pubnub** server is listed under **Available Tools & Resources**.\n3. In chat, invoke available resources:\n - `pubnub://docs/javascript` — Fetch PubNub JavaScript SDK documentation\n - `pubnub://docs/python` — Fetch PubNub Python SDK documentation\n - `pubnub://docs/java` — Fetch PubNub Java SDK documentation\n - `pubnub://functions` — List PubNub Functions (static content from `resources/pubnub_functions.md`)\n4. Approve resource execution when prompted, or enable **auto-run** in settings for trusted resources.\n\n## Real-Time Message Subscription\n\nThe `pubnub_subscribe_and_receive_messages` tool provides real-time message listening capabilities, allowing you to subscribe to PubNub channels and receive messages as they're published. This tool automatically handles subscription lifecycle, message collection, and cleanup.\n\n### Key Features\n\n- **Flexible Message Collection**: Wait for a single message (default) or specify how many messages to collect\n- **Timeout Support**: Set optional timeouts to prevent indefinite waiting\n- **Automatic Cleanup**: Automatically unsubscribes and cleans up listeners after receiving the specified number of messages or timeout\n- **Structured Response**: Returns detailed message information including channel, content, publisher, and timetoken\n\n### Usage Examples\n\n```bash\n# Subscribe and wait for one message (default behavior)\n\"Subscribe to the 'my_channel' channel and wait for one message\"\n\n# Collect multiple messages with timeout\n\"Subscribe to the 'notifications' channel and collect 5 messages with a 30-second timeout\"\n\n# Listen with timeout only\n\"Listen for messages on the 'alerts' channel for 10 seconds\"\n```\n\n### Parameters\n\n- `channel` (required): Name of the PubNub channel to subscribe to\n- `messageCount` (optional, default: 1): Number of messages to wait for before unsubscribing\n- `timeout` (optional): Timeout in milliseconds to avoid waiting indefinitely\n\n### Response Format\n\nThe tool returns a JSON object containing:\n- `channel`: The subscribed channel name\n- `messageCount`: Number of messages actually received\n- `messages`: Array of message objects with channel, message content, publisher, timetoken, and subscription info\n\n## Claude Code\n\n```shell\n## Install the MCP server if you have node >= 18\nclaude mcp add --scope user pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp\n\n## Install the MCP server if you have node < 18 and need to point to the full path of node\nclaude mcp add --scope user 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\n\n## Install the MCP server using Docker\n# Ensure your PubNub keys are set as environment variables:\nexport PUBNUB_PUBLISH_KEY=your_publish_key\nexport PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n\n# Depending on your machine’s CPU architecture, you may need to specify the target platform.\n# For example:\n# docker run --platform linux/arm64 -i pubnub/pubnub-mcp-server\n# docker run --platform linux/amd64 -i pubnub/pubnub-mcp-server\n\nclaude mcp add --scope user pubnub -- docker run -i \\\n -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \\\n -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \\\n pubnub/pubnub-mcp-server\n```\n\nAnd the output will be:\n```shell\nAdded stdio MCP server pubnub with command: npx -y @pubnub/mcp to local config\n```\n\n### Example prompt\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n```\n\n```shell\nclaude \"publish a message 'hi' to the 'my_channel' pubnub channel.\"\n\n╭───────────────────────────────────────────────────╮\n│ ✻ Welcome to Claude Code research preview! │\n│ │\n│ /help for help, /status for your current setup │\n│ │\n│ cwd: /Users/stephen/Projects/mcp-pubnub │\n╰───────────────────────────────────────────────────╯\n\n ※ Tip: Press Option+Enter to send a multi-line message\n\n> publish a message 'hi' to the 'my_channel' pubnub channel.\n\n⏺ I'll publish a message to the PubNub channel for you.\n\n⏺ pubnub:publish_pubnub_message (MCP)(channel: \"my_channel\", message: \"hi\")…\n ⎿ Message published successfully. Timetoken: 17467422499409217\n\n⏺ Message published successfully to \"my_channel\".\n```\n\nRemove the MCP server with:\n\n```shell\nclaude mcp remove pubnub\n```\n\n## Using VS Code\n\nTo install the PubNub MCP Server in VS Code:\n\n### Prerequisites\n- VS Code with GitHub Copilot installed and logged in\n- Node.js (>= 18) and npm\n- A workspace opened in VS Code\n\n### Installation Steps\n\n1. Open the Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`)\n2. Type `MCP` and select **MCP: Add Server**\n3. Choose **NPM package** when prompted\n4. Enter `@pubnub/mcp` as the package name\n5. VS Code will install the package and automatically open the `mcp.json` configuration file\n6. Add your PubNub Publish and Subscribe keys to the configuration:\n\n```json\n{\n \"mcpServers\": {\n \"@pubnub/mcp\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@pubnub/mcp\"],\n \"env\": {\n \"PUBNUB_PUBLISH_KEY\": \"YOUR_PUBLISH_KEY\",\n \"PUBNUB_SUBSCRIBE_KEY\": \"YOUR_SUBSCRIBE_KEY\"\n }\n }\n }\n}\n```\n\n7. Save the `mcp.json` file\n8. Restart VS Code or reload the window to activate the MCP server\n\nThe PubNub MCP server will now be available in VS Code with GitHub Copilot, providing access to PubNub SDK documentation and real-time messaging capabilities.\n\n## Using Claude Desktop\n\nIf you prefer the Docker-based MCP server in Claude Desktop:\n\n1. Ensure your PubNub keys are exported in your shell:\n ```bash\n export PUBNUB_PUBLISH_KEY=your_publish_key\n export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key\n ```\n2. In the **Tools** section of Claude Desktop, add a new tool named **pubnub**.\n3. Set the **Command** to `docker`.\n4. Set **Arguments** to:\n ```json\n [\n \"run\",\n \"-i\",\n \"-e\",\n \"PUBNUB_PUBLISH_KEY\",\n \"-e\",\n \"PUBNUB_SUBSCRIBE_KEY\",\n \"pubnub/pubnub-mcp-server\"\n ]\n ```\n\n> **Note:** On some machines (e.g., Apple Silicon), you may need to specify the Docker platform.\n> Insert `--platform linux/arm64` (or `--platform linux/amd64`) immediately after `\"run\"` in the Arguments array. For example:\n>\n> ```json\n> [\n> \"run\",\n> \"--platform\", \"linux/arm64\",\n> \"-i\",\n> \"-e\", \"PUBNUB_PUBLISH_KEY\",\n> \"-e\", \"PUBNUB_SUBSCRIBE_KEY\",\n> \"pubnub/pubnub-mcp-server\"\n> ]\n> ```\n5. Save the configuration.\n\nClaude Desktop will invoke the PubNub MCP server container via Docker.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Troubleshooting\n\n- Must be in agent mode to use MCP servers.\n- Verify Node.js and npm installation.\n- Ensure `index.js` has execute permission.\n- Check that the `command`, `args`, and `env` settings are correct.\n- Review Cursor IDE logs for MCP startup errors.\n\n## Direct JSON-RPC Command-Line Usage\n\nYou can invoke the MCP server directly over STDIN/STDOUT using JSON-RPC v2.0.\nEnsure your PubNub keys are set in the environment, for example:\n```bash\nPUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY \\\nPUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY \\\n node index.js\n```\n\nOnce the server is running (or using a one-off invocation), send requests by piping JSON into `node index.js`. Examples:\n```bash\n# 1) List available tools\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' \\\n | node index.js\n\n# 2) Read PubNub JavaScript SDK documentation\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":\n {\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' \\\n | node index.js\n\n# 3) Read PubNub Functions Resource docs (static Markdown)\necho '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_resources\",\"arguments\":{\"document\":\"pubnub_functions\"}}}' \\\n | node index.js\n\n```\n\n## Quick JSON-RPC Examples\n\nBelow are simplified JSON-RPC v2.0 command-line examples using STDIN/STDOUT to fetch PubNub SDK documentation and publish messages.\n\n### 1) Fetch PubNub JavaScript SDK documentation\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"read_pubnub_sdk_docs\",\"arguments\":{\"language\":\"javascript\"}}}' | node index.js\n```\n\n### 2) Publish a message to a PubNub channel\n```bash\nPUBNUB_PUBLISH_KEY=demo \\\nPUBNUB_SUBSCRIBE_KEY=demo \\\necho '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"publish_pubnub_message\",\"arguments\":{\"channel\":\"my_channel\",\"message\":\"Hello, PubNub MCP JSON-RPC!\"}}}' \\\n | node index.js\n```\n\n## Disabling PubNub Analytics Subscription\n\nTo disable the PubNub server analytics subscription, set the following environment variable:\n\n```bash\nexport MCP_SUBSCRIBE_ANALYTICS_DISABLED=true\n```\n\n## Running All Tests\n\nYou can run the complete test suite (unit tests, SSE tests, model tooling tests, and benchmarks) with:\n\n```bash\nnode test_all.js\n```\n\nOr via npm:\n\n```bash\nnpm run test-all\n```\n\n## Publishing to MCP Registry\n\nThis server is automatically published to the MCP Registry when new versions are released. The publishing process uses GitHub Actions for automated CI/CD.\n\n### Automated Publishing Setup\n\nThe repository includes automated publishing configuration:\n\n- **`server.json`** - MCP registry configuration file\n- **`.github/workflows/publish-mcp.yml`** - GitHub Actions workflow for automated publishing\n\n### Prerequisites for Publishing\n\n1. **NPM Token**: Add `NPM_TOKEN` as a secret in your GitHub repository:\n - Go to GitHub repo Settings → Secrets → Actions\n - Add `NPM_TOKEN` with your npm publishing token\n\n2. **Version Management**: Ensure `package.json` version is properly maintained\n\n### Publishing a New Version\n\nTo publish a new version to both npm and the MCP Registry:\n\n```bash\n# Update version (patch, minor, or major)\nnpm version patch\n\n# Push changes and tags to trigger automated publishing\ngit push origin main\ngit push origin --tags\n```\n\n### Automated Publishing Process\n\nWhen you push a version tag (e.g., `v1.0.98`), the GitHub Actions workflow automatically:\n\n1. **Runs Tests** - Executes the test suite to ensure quality\n2. **Publishes to NPM** - Updates the npm package (`@pubnub/mcp`)\n3. **Publishes to MCP Registry** - Updates the MCP Registry entry using GitHub OIDC authentication\n4. **Syncs Versions** - Ensures version consistency between `package.json` and `server.json`\n\n### Manual Publishing (Alternative)\n\nIf you need to publish manually:\n\n```bash\n# Install the MCP Publisher CLI\ncurl -fsSL https://registry.modelcontextprotocol.io/install.sh | bash\n\n# Login using GitHub authentication (for io.github.pubnub.* namespace)\nmcp-publisher login github\n\n# Publish to the MCP Registry\nmcp-publisher publish\n```\n\n### Registry Information\n\n- **Registry Name**: `io.github.pubnub.mcp-server`\n- **Package**: `npm:@pubnub/mcp`\n- **Namespace**: `io.github.pubnub.*` (GitHub-authenticated)\n- **Authentication**: GitHub OIDC (automated) or GitHub OAuth (manual)\n\n","url","https://github.com/stephenlb/pubnub-mcp-server","githubRepository",{"_164":165,"_166":167,"_168":169,"_16":170,"_171":105,"_31":172,"_127":173,"_175":176,"_177":178,"_180":181},"defaultBranch","main","fullName","pubnub/pubnub-mcp-server","githubTreeId",330843,12937,"language","pubnub-mcp-server",{"_131":132,"_109":174},"FPM2Qjsmnp","recentStargazers",0,"spdxLicense",{"_31":179},"MIT License","stargazers",7,"glamaJson","inspectable",true,"npmPackage",{"_31":187,"_188":189},"@pubnub/mcp","weeklyDownloads",489,"supportedPlatforms","scores",{"_193":194,"_195":194,"_196":194},"license",100,"quality","security","simpleIcon","toolCount",11,"u5x3u3txbh","updatedAt","2025-09-27T00:35:35.017601Z","meta",[205,208,210,217,220,222,225,228,231,234,237,239,242,245,247,249,251,253,255],{"_206":207},"title","PubNub MCP Server | Glama",{"_209":40,"_31":29},"content",{"_211":212,"_213":214,"_215":216},"href","https://glama.ai/mcp/servers/@pubnub/pubnub-mcp-server","rel","canonical","tagName","link",{"_209":41,"_218":219},"property","og:title",{"_209":40,"_218":221},"og:description",{"_209":223,"_218":224},"https://glama.ai/logo.png","og:logo",{"_209":226,"_218":227},"https://glama.ai/mcp/servers/@pubnub/pubnub-mcp-server/og-image","og:image",{"_209":229,"_218":230},"630","og:image:height",{"_209":232,"_218":233},"1200","og:image:width",{"_209":235,"_218":236},"website","og:type",{"_209":212,"_218":238},"og:url",{"_209":240,"_218":241},"Glama – MCP Hosting Platform","og:site_name",{"_209":243,"_31":244},"summary_large_image","twitter:card",{"_209":240,"_31":246},"twitter:title",{"_209":40,"_31":248},"twitter:description",{"_209":226,"_31":250},"twitter:image",{"_209":229,"_31":252},"twitter:image:height",{"_209":232,"_31":254},"twitter:image:width",{"_256":257},"script:ld+json",{"_258":259,"_260":261},"@context","http://schema.org","@graph",[262],{"_258":263,"_264":265,"_266":267},"https://schema.org","@type","BreadcrumbList","itemListElement",[268,275,279,283],{"_264":269,"_270":271,"_31":272,"_273":274},"ListItem","item","/","Glama","position",1,{"_264":269,"_270":276,"_31":277,"_273":278},"/mcp","MCP",2,{"_264":269,"_270":280,"_31":281,"_273":282},"/mcp/servers","Servers",3,{"_264":269,"_270":284,"_31":41,"_273":285},"/mcp/servers/@pubnub/pubnub-mcp-server",4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_290":291,"_27":297,"_323":324,"_203":335,"_333":359,"_360":361},"blob",{"_209":292,"_293":294,"_295":296},"#!/bin/bash\ndocker run -i stephenlb/pubnub-mcp-server\n","fileName","docker-run.sh","size",54,{"_83":84,"_13":298,"_95":40,"_96":40,"_16":97,"_98":299,"_31":41,"_125":306,"_133":-5,"_134":309,"_191":322,"_197":-5,"_106":172,"_198":199,"_109":200,"_201":202},[86,87,88,89,90,91,92,93,94],[300,302,304],{"_101":301,"_29":108,"_109":110},{"_103":104,"_31":105,"_106":107},{"_101":303,"_29":116,"_109":117},{"_103":113,"_31":114,"_106":115},{"_101":305,"_29":123,"_109":124},{"_103":120,"_31":121,"_106":122},{"_127":307,"_106":132},{"_129":308},{"_131":132},{"_136":310,"_157":317,"_162":318,"_182":-5,"_183":184,"_185":321,"_190":-5},{"_138":311,"_154":316,"_143":156},{"_140":312,"_145":313,"_148":314,"_151":315},{"_29":142,"_143":144},{"_29":147,"_143":144},{"_29":150,"_143":144},{"_29":153,"_143":144},[],{"_33":159,"_160":161},{"_164":165,"_166":167,"_168":169,"_16":170,"_171":105,"_31":172,"_127":319,"_175":176,"_177":320,"_180":181},{"_131":132,"_109":174},{"_31":179},{"_31":187,"_188":189},{"_193":194,"_195":194,"_196":194},"member",{"_325":326,"_329":330,"_331":294,"_168":169,"_332":287,"_333":294,"_334":184,"_295":296,"_143":290},"commit",{"_327":328},"sha","22562a7ff609447c9f5494f8df770911382245e6","contentStoredObjectPointerId",5204697,"fullPath","indexable","path","safeToDisplayAsText",[336,338,340,342,344,345,346,348,349,350,351,352,353,354,355,356,357,358],{"_206":337},"docker-run.sh | PubNub MCP Server | Glama",{"_209":339,"_31":29},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_211":341,"_213":214,"_215":216},"https://glama.ai/mcp/servers/@pubnub/pubnub-mcp-server/blob/22562a7ff609447c9f5494f8df770911382245e6/",{"_209":343,"_218":219},"docker-run.sh | PubNub MCP Server",{"_209":339,"_218":221},{"_209":223,"_218":224},{"_209":347,"_218":227},"https://glama.ai/generated-images/og?title=docker-run.sh+%7C+PubNub+MCP+Server",{"_209":229,"_218":230},{"_209":232,"_218":233},{"_209":235,"_218":236},{"_209":341,"_218":238},{"_209":240,"_218":241},{"_209":243,"_31":244},{"_209":240,"_31":246},{"_209":339,"_31":248},{"_209":347,"_31":250},{"_209":229,"_31":252},{"_209":232,"_31":254},"","treeMembers",[362,366,369,372,375,378,381,384,387,390,393,396,398,401,404,407,410,413,416,419,422,425,428,431,434,437,440,443,446,449,452,455,458,461],{"_325":363,"_331":364,"_333":364,"_143":365},{"_327":328},"context","tree",{"_325":367,"_331":368,"_333":368,"_143":365},{"_327":328},".github",{"_325":370,"_331":371,"_333":371,"_143":365},{"_327":328},"lib",{"_325":373,"_331":374,"_333":374,"_143":365},{"_327":328},"resources",{"_325":376,"_331":377,"_333":377,"_143":290},{"_327":328},"benchmark_mcp.sh",{"_325":379,"_331":380,"_333":380,"_143":290},{"_327":328},"benchmark_results.json",{"_325":382,"_331":383,"_333":383,"_143":290},{"_327":328},"benchmark_results.md",{"_325":385,"_331":386,"_333":386,"_143":290},{"_327":328},"chat_sdk_urls.txt",{"_325":388,"_331":389,"_333":389,"_143":290},{"_327":328},"docker-build.sh",{"_325":391,"_331":392,"_333":392,"_143":290},{"_327":328},"Dockerfile",{"_325":394,"_331":395,"_333":395,"_143":290},{"_327":328},"docker-publish.sh",{"_325":397,"_331":294,"_333":294,"_143":290},{"_327":328},{"_325":399,"_331":400,"_333":400,"_143":290},{"_327":328},"download-events-actions-docs.js",{"_325":402,"_331":403,"_333":403,"_143":290},{"_327":328},"download-sdk-docs.js",{"_325":405,"_331":406,"_333":406,"_143":290},{"_327":328},"events_and_actions_urls.txt",{"_325":408,"_331":409,"_333":409,"_143":290},{"_327":328},"fetch_context7_markdown.sh",{"_325":411,"_331":412,"_333":412,"_143":290},{"_327":328},"fetch_pubnub_objects.js",{"_325":414,"_331":415,"_333":415,"_143":290},{"_327":328},".gitignore",{"_325":417,"_331":418,"_333":418,"_143":290},{"_327":328},"index.js",{"_325":420,"_331":421,"_333":421,"_143":290},{"_327":328},"LICENSE",{"_325":423,"_331":424,"_333":424,"_143":290},{"_327":328},"mcp-config.json",{"_325":426,"_331":427,"_333":427,"_143":290},{"_327":328},"package.json",{"_325":429,"_331":430,"_333":430,"_143":290},{"_327":328},"package-lock.json",{"_325":432,"_331":433,"_333":433,"_143":290},{"_327":328},"README.md",{"_325":435,"_331":436,"_333":436,"_143":290},{"_327":328},"server.json",{"_325":438,"_331":439,"_333":439,"_143":290},{"_327":328},"test_all.js",{"_325":441,"_331":442,"_333":442,"_143":290},{"_327":328},"test_authkey_usage.sh",{"_325":444,"_331":445,"_333":445,"_143":290},{"_327":328},"test_chat_sdk.js",{"_325":447,"_331":448,"_333":448,"_143":290},{"_327":328},"test.js",{"_325":450,"_331":451,"_333":451,"_143":290},{"_327":328},"test_sse.js",{"_325":453,"_331":454,"_333":454,"_143":290},{"_327":328},"test_tools_consistency.js",{"_325":456,"_331":457,"_333":457,"_143":290},{"_327":328},"test_tools_model.sh",{"_325":459,"_331":460,"_333":460,"_143":290},{"_327":328},"todo-list.md",{"_325":462,"_331":463,"_333":463,"_143":290},{"_327":328},"update_dockerhub_overview.py","actionData","errors"]

MCP directory API