mcp-chzzk
mcp-chzzk
MCP (Model Context Protocol) server for Chzzk, Naver's Korean live-streaming platform.
Exposes Chzzk channel, live, search, and VOD lookups as MCP tools so Claude (or any MCP client) can query them.
⚠️ Chzzk does not publish an official public API. This server calls the same undocumented endpoints the web client uses. They may change without notice.
Tools
Tool | Description |
| Channel metadata (name, follower count, description, verified mark) |
| Live status — is broadcasting, title, category, viewer count, start time |
| Extended live info including 720p thumbnail URL |
| Search channels by keyword |
| Search VOD by keyword |
| Search currently live broadcasts by keyword |
| List currently live broadcasts (popularity order) |
| List recent VOD for a channel |
Channel arguments accept either a 32-hex channel id or a chzzk.naver.com/[live/]<id> URL.
Install & Build
npm install
npm run buildConfiguration
All Chzzk endpoints exposed here are public — no authentication is required.
For private or restricted content (adult-only channels, subscriber views), provide Naver session cookies via env vars:
export CHZZK_NID_AUT="..."
export CHZZK_NID_SES="..."You can extract these from your browser's DevTools → Application → Cookies → naver.com while logged in.
Run
Direct:
node build/index.jsWith MCP Inspector (browser-based debugger):
npm run inspectUse from Claude Code
Add to ~/.claude/settings.json or .mcp.json:
{
"mcpServers": {
"chzzk": {
"command": "node",
"args": ["/absolute/path/to/mcp-chzzk/build/index.js"],
"env": {
"CHZZK_NID_AUT": "",
"CHZZK_NID_SES": ""
}
}
}
}Then in Claude Code, run /mcp to confirm the chzzk server appears and the tools are listed.
References
hacs-chzzk — Home Assistant integration with the verified Chzzk endpoints this server is built on.
twitch-mcp-server — structural reference.
License
MIT