Skip to main content
Glama
jx3box-mcp

jx3box-mcp

by zenenznze

jx3box-mcp

Read-only MCP server (and a small CLI) for the public JX3BOX (魔盒,剑网3 / JX3) endpoints: posts, macro guides, build (配装) pages and Node v2 game data.

  • No API key, account, cookie or token. Every request goes to the public JX3BOX APIs with a plain User-Agent. Nothing is collected or stored.

  • No dependencies. Pure Node.js (>= 18.17) ESM; npx or a global install is enough.

  • Read-only. The tools fetch and parse; they never write to JX3BOX.

Not affiliated with or endorsed by JX3BOX / 剑网3. Data and rate limits belong to JX3BOX; respect their terms and do not hammer the API.

Install

npx -y jx3box-mcp            # MCP stdio server, no install step
# or
npm install -g jx3box-mcp

Related MCP server: xhs-mcp

Use as an MCP server

MCP client configuration (Claude Desktop, Codex, Cursor, Magpie Library, …):

{
  "mcpServers": {
    "jx3box": {
      "command": "npx",
      "args": ["-y", "jx3box-mcp"]
    }
  }
}

Magpie Library has the same shape:

magpie library mcp add jx3box npx -y jx3box-mcp

Tools:

Tool

What it returns

jx3box_get_post

A post by ID or `jx3box.com/macro

jx3box_get_macro

A macro post's scripts, instructions, talent data and metadata

jx3box_search

CMS search over posts: keyword, kind (`all

jx3box_get_build

A build (配装) page by post URL or ID

jx3box_get_game_data

Documented /api/node/v2 game data, e.g. endpoint: "item"

The server speaks MCP over stdio (newline-delimited JSON-RPC); Content-Length framed clients are accepted too.

CLI

npx -y jx3box-mcp --help          # MCP server help
npx -y jx3box get 110420
npx -y jx3box get https://www.jx3box.com/macro/110420 --format json
npx -y jx3box search macro --keyword 冰心诀 --season 苍生铸世 --limit 10
npx -y jx3box search all --keyword 配装 --format json

Data sources

  • CMS posts: https://cms.jx3box.com/api/cms/post/{id}, /posts (search), /app/pz/{id} (builds)

  • Game data: https://node.jx3box.com/api/node/v2/{endpoint}

HTTP and API errors are surfaced as tool errors; there is no automatic retry and no attempt to bypass access controls.

Development

npm test        # unit tests, no network

The tests inject a fake fetch, so they never touch JX3BOX.

License

MIT. See LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      SocialDataX(社媒数据助手)is a read-only MCP for 小红书 / Xiaohongshu / XHS / RedNote. Hosted version 0.1.15 provides 35 tools for note and user search, details, comments, creator data, products, and video transcripts. Search video notes with xhs_search_notes(note_type="video").
      35
      28 npm
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A lightweight MCP server that provides read-only access to Xiaohongshu (Little Red Book) data, enabling search, note details, user profiles, and trending feeds via direct HTTP APIs.
      5
      16 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides read-only access to Old School RuneScape Wiki data, returning structured content with source provenance via MCP tools for searching pages, items, monsters, quests, shops, and drop sources.
      10
      MIT