PubNub MCP 서버

MCP 서버 로고

커서 IDE용 PubNub 모델 컨텍스트 프로토콜(MCP) 서버

이 저장소는 PubNub SDK 문서와 PubNub API 리소스를 LLM 기반 도구에 노출하는 CLI 기반 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 이를 통해 LLM AI 에이전트가 PubNub SDK 및 API를 이해하고 상호 작용하는 능력이 향상됩니다.

PubNub MCP 사용 시 vs 미사용 시

특징

STDIN/STDOUT을 통한 JSON-RPC를 통해 PubNub과 상호작용하기 위한 도구를 제공하는 MCP 서버입니다.
PubNub SDK 공식 문서(HTML → Markdown)를 검색하세요:
- 언어: JavaScript, Python, Java, Go, Ruby, Swift, Objective-C, C#, PHP, Rust, Unity, Kotlin, Unreal.
- API 참조 섹션: 구성, 게시 및 구독, 상태, 액세스 관리자, 채널 그룹, 저장소 및 재생, 모바일 푸시, 객체, 파일, 메시지 작업, 기타, 함수.
resources 마크다운 파일(예: pubnub_concepts , pubnub_features , pubnub_security , how_to_send_receive_json , how_to_encrypt_messages_files 등)에서 PubNub 개념 가이드와 방법 문서를 가져옵니다.
publish_pubnub_message 사용하여 PubNub 채널에 메시지를 게시하고 timetoken을 반환합니다.
get_pubnub_messages 사용하여 하나 이상의 채널에서 과거 메시지를 가져와서 JSON 형식으로 메시지 내용과 메타데이터를 반환합니다.
get_pubnub_presence 사용하여 채널 및 채널 그룹의 실시간 존재 정보(점유 수, 구독자 UUID)를 검색합니다.
write_pubnub_app 사용하여 여러 언어로 PubNub SDK를 초기화하기 위한 코드 조각을 포함하여 PubNub 애플리케이션을 만드는 단계별 지침을 생성합니다.
환경 변수 구성: SDK 작업 인증을 위해 PUBNUB_PUBLISH_KEY 및 PUBNUB_SUBSCRIBE_KEY 지원합니다.
jsdom 과 turndown 사용하여 원격 HTML 문서를 Markdown으로 변환하여 일관된 문서 형식을 유지합니다.
모든 도구 매개변수에 대해 Zod 스키마를 통한 입력 검증을 통해 강력한 오류 처리를 보장합니다.
McpServer 및 StdioServerTransport 와 함께 Model Context Protocol SDK( @modelcontextprotocol/sdk )를 활용한 확장 가능한 도구 정의.

예시 프롬프트

"PubNub에서 다중 사용자 채팅 기능을 내장하고, 사용자가 스트리밍 비디오를 시청할 수 있는 PubNub 앱을 작성하세요."
"지도가 포함된 주문형 식료품 배달 서비스를 제공하는 PubNub 앱을 작성하세요."
"실시간으로 패키지의 위치를 추적하는 PubNub 앱을 작성하세요."
"실시간으로 날씨 예보를 보여주는 PubNub 앱을 작성하세요."
"친구와 함께 멀티플레이어 게임을 즐길 수 있는 PubNub 앱을 작성하세요."
"실시간 주가와 뉴스 업데이트를 보여주는 PubNub 앱을 작성하세요."
"사용자가 플레이리스트를 만들어 친구들과 공유할 수 있는 PubNub 앱을 작성하세요."
" my_channel 채널을 구독하고 콘솔에 메시지를 기록하는 PubNub JavaScript 앱을 빌드하세요."
" Hello, PubNub! 라는 메시지와 함께 my_channel 채널에 메시지를 게시하세요."
" subscribe() 에 대한 PubNub JavaScript SDK 설명서를 보여주세요."
"사용 가능한 PubNub 함수를 모두 나열하세요."
" publish() 메서드에 대한 Python SDK 문서를 가져옵니다."
" test 채널의 메시지 기록을 가져옵니다."
test 채널과 default 채널 그룹에 대한 상태 정보(점유 및 UUID)를 검색합니다.

이 작업에는 Node.js(>= 18)와 npm( https://nodejs.org/ )이 필요합니다. npx 자동으로 최신 MCP 서버를 가져와서 실행합니다.

필수 조건

Node.js(>= 18) 및 npm
MCP를 지원하는 커서 IDE
(선택 사항) 라이브 예제를 위한 PubNub 계정 및 API 키

설치

PubNub MCP 서버를 로컬에서 실행하거나 npx를 통해 Cursor IDE에 추가하는 가장 좋은 방법은 다음과 같습니다.

지엑스피1

구성

MCP 서버를 사용하려면 커서가 에이전트 모드에 있어야 합니다.

커서 IDE는 JSON 구성 파일을 통해 MCP 서버를 검색합니다. PubNub MCP 서버를 전역 또는 프로젝트별로 구성하세요.

글로벌 구성

~/.cursor/mcp.json 편집하거나 생성합니다.

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

프로젝트 구성

프로젝트 디렉토리에 .cursor/mcp.json 만듭니다.

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

Docker 기반 구성

Docker를 통해 MCP 서버를 실행하려면 PubNub 키를 환경 변수로 설정하세요.

export PUBNUB_PUBLISH_KEY=YOUR_PUBLISH_KEY
export PUBNUB_SUBSCRIBE_KEY=YOUR_SUBSCRIBE_KEY

그런 다음 ~/.cursor/mcp.json (또는 프로젝트에서 .cursor/mcp.json )을 구성합니다.

{
  "mcpServers": {
    "pubnub": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "PUBNUB_PUBLISH_KEY",
        "-e",
        "PUBNUB_SUBSCRIBE_KEY",
        "pubnub/pubnub-mcp-server"
      ]
    }
  }
}

command MCP 서버를 시작하기 위한 실행 파일을 지정합니다.
args 명령에 전달할 인수를 지정합니다.
env 서버 프로세스에 대한 환경 변수를 설정합니다.

커서 IDE에서 사용

커서 IDE를 다시 시작하거나 새로운 세션을 엽니다.
MCP 설정 창을 열고 pubnub 서버가 사용 가능한 도구 및 리소스 에 나열되어 있는지 확인하세요.
채팅에서 사용 가능한 리소스를 호출합니다.
- pubnub://docs/javascript — PubNub JavaScript SDK 설명서 가져오기
- pubnub://docs/python — PubNub Python SDK 문서 가져오기
- pubnub://docs/java — PubNub Java SDK 문서 가져오기
- pubnub://functions — PubNub 함수 목록( resources/pubnub_functions.md 의 정적 콘텐츠)
메시지가 표시되면 리소스 실행을 승인하거나 신뢰할 수 있는 리소스에 대한 설정에서 자동 실행을 활성화합니다.

클로드 코드

## Install the MCP server if you have node >= 18
claude mcp add pubnub -e PUBNUB_PUBLISH_KEY=your_publish_key -e PUBNUB_SUBSCRIBE_KEY=your_subscribe_key -- npx -y @pubnub/mcp

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

## Install the MCP server using Docker
# Ensure your PubNub keys are set as environment variables:
export PUBNUB_PUBLISH_KEY=your_publish_key
export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key

# Depending on your machine’s CPU architecture, you may need to specify the target platform.
# For example:
#   docker run --platform linux/arm64 -i pubnub/pubnub-mcp-server
#   docker run --platform linux/amd64 -i pubnub/pubnub-mcp-server

claude mcp add pubnub -- docker run -i \
  -e PUBNUB_PUBLISH_KEY=$PUBNUB_PUBLISH_KEY \
  -e PUBNUB_SUBSCRIBE_KEY=$PUBNUB_SUBSCRIBE_KEY \
  pubnub/pubnub-mcp-server

출력은 다음과 같습니다.

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

예시 프롬프트

claude "publish a message 'hi' to the 'my_channel' pubnub channel."

claude "publish a message 'hi' to the 'my_channel' pubnub channel."

╭───────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code research preview!        │
│                                                   │
│   /help for help, /status for your current setup  │
│                                                   │
│   cwd: /Users/stephen/Projects/mcp-pubnub         │
╰───────────────────────────────────────────────────╯

 ※ Tip: Press Option+Enter to send a multi-line message

> publish a message 'hi' to the 'my_channel' pubnub channel.

⏺ I'll publish a message to the PubNub channel for you.

⏺ pubnub:publish_pubnub_message (MCP)(channel: "my_channel", message: "hi")…
  ⎿  Message published successfully. Timetoken: 17467422499409217

⏺ Message published successfully to "my_channel".

다음을 사용하여 MCP 서버를 제거합니다.

claude mcp remove pubnub

Claude Desktop 사용

Claude Desktop에서 Docker 기반 MCP 서버를 선��하는 경우:

PubNub 키가 셸로 내보내졌는지 확인하세요.
export PUBNUB_PUBLISH_KEY=your_publish_key export PUBNUB_SUBSCRIBE_KEY=your_subscribe_key
Claude Desktop의 도구 섹션에서 pubnub 이라는 이름의 새 도구를 추가합니다.
명령을 docker 로 설정합니다.
인수 설정:
[ "run", "-i", "-e", "PUBNUB_PUBLISH_KEY", "-e", "PUBNUB_SUBSCRIBE_KEY", "pubnub/pubnub-mcp-server" ]

참고: 일부 머신(예: Apple Silicon)에서는 Docker 플랫폼을 지정해야 할 수 있습니다. Arguments 배열의 "run" 바로 뒤에 --platform linux/arm64 (또는 --platform linux/amd64 )를 삽입하세요. 예:
[ "run", "--platform", "linux/arm64", "-i", "-e", "PUBNUB_PUBLISH_KEY", "-e", "PUBNUB_SUBSCRIBE_KEY", "pubnub/pubnub-mcp-server" ]

구성을 저장합니다.

Claude Desktop은 Docker를 통해 PubNub MCP 서버 컨테이너를 호출합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

문제 해결

MCP 서버를 사용하려면 에이전트 모드에 있어야 합니다.
Node.js와 npm 설치를 확인하세요.
index.js 에 실행 권한이 있는지 확인하세요.
command , args , env 설정이 올바른지 확인하세요.
MCP 시작 오류를 확인하려면 Cursor IDE 로그를 검토하세요.

직접 JSON-RPC 명령줄 사용

JSON-RPC v2.0을 사용하여 STDIN/STDOUT을 통해 MCP 서버를 직접 호출할 수 있습니다. PubNub 키가 환경에 설정되어 있는지 확인하세요. 예:

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

서버가 실행 중이거나 일회성 호출을 사용하는 경우 JSON을 node index.js 로 파이프하여 요청을 보냅니다. 예:

# 1) List available tools
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
  | node index.js

# 2) Read PubNub JavaScript SDK documentation
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":
  {"name":"read_pubnub_sdk_docs","arguments":{"language":"javascript"}}}' \
  | node index.js

# 3) Read PubNub Functions Resource docs (static Markdown)
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"read_pubnub_resources","arguments":{"document":"pubnub_functions"}}}' \
  | node index.js

빠른 JSON-RPC 예제

아래는 STDIN/STDOUT을 사용하여 PubNub SDK 문서를 가져오고 메시지를 게시하는 간소화된 JSON-RPC v2.0 명령줄 예제입니다.

1) PubNub JavaScript SDK 문서 가져오기

echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"read_pubnub_sdk_docs","arguments":{"language":"javascript"}}}' | node index.js

2) PubNub 채널에 메시지 게시

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

PubNub SDK 설명서와 기능 리소스를 Cursor IDE와 같은 LLM 기반 도구에 노출하는 CLI 기반 모델 컨텍스트 프로토콜 서버로, 사용자가 자연어 프롬프트를 통해 설명서를 가져오고 PubNub 채널과 상호 작용할 수 있도록 합니다.

Related MCP Servers

MCP Server for Cursor
AntDX316
-
security
F
license
-
quality
A Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
Last updated -
738
1
Python
Cursor MCP Installer
matthewdcage
A
security
A
license
A
quality
A Model Context Protocol (MCP) server for Cursor IDE that simplifies the installation and configuration of other MCP servers.
Last updated -
3
231
63
JavaScript
MIT License
Code Summarizer MCP
nicobailon
-
security
F
license
-
quality
Allows LLM tools like Claude Desktop and Cursor AI to access and summarize code files through a Model Context Protocol server, providing structured access to codebase content without manual copying.
Last updated -
1
TypeScript
MCP OpenAPI Server
ReAPI-com
A
security
A
license
A
quality
A Model Context Protocol server that loads multiple OpenAPI specifications and exposes them to LLM-powered IDE integrations, enabling AI to understand and work with your APIs directly in development tools like Cursor.
Last updated -
7
24
53
TypeScript
MIT License

View all related MCP servers

PubNub MCP Server

커서 IDE용 PubNub 모델 컨텍스트 프로토콜(MCP) 서버

특징

예시 프롬프트

필수 조건

설치

구성

글로벌 구성

프로젝트 구성

Docker 기반 구성

커서 IDE에서 사용

클로드 코드

예시 프롬프트

Claude Desktop 사용

특허

문제 해결

직접 JSON-RPC 명령줄 사용

빠른 JSON-RPC 예제

1) PubNub JavaScript SDK 문서 가져오기

2) PubNub 채널에 메시지 게시

Tools

Related MCP Servers

MCP Server for Cursor

Cursor MCP Installer

Code Summarizer MCP

MCP OpenAPI Server

New MCP Servers

MCP directory API