How do I use xiaoheihe-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@xiaoheihe-mcp 搜一下小黑盒上关于原神的帖子" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

xiaoheihe-mcp

by foxlesbiao

Overview Schema Source Related Servers Discussions Admin

Python

Local

xiaoheihe-mcp

小黑盒社区只读 MCP Server 和 CLI，支持搜索、话题、游戏、帖子、评论、用户帖子和热点浏览。默认优先使用本地 Unidbg App 原生签名；若本地签名资源不可用，则回退公开 Web 接口签名。不包含发帖、点赞、关注等写操作。

安装

git clone https://github.com/foxlesbiao/xiaoheihe-mcp.git
cd xiaoheihe-mcp
uv venv .venv
uv pip install -e .

Related MCP server: reddit-monitor-mcp

MCP 配置

{
  "mcpServers": {
    "xiaoheihe": {
      "command": "/absolute/path/to/xiaoheihe-mcp/.venv/bin/xiaoheihe-mcp"
    }
  }
}

Tools

Tool	说明
`xiaoheihe_search`	通用搜索，默认搜帖子，也可搜游戏/话题
`xiaoheihe_post_detail`	帖子详情、正文和评论
`xiaoheihe_user_posts`	用户资料摘要与公开帖子
`xiaoheihe_topic_search`	话题/社区搜索
`xiaoheihe_topic_posts`	话题下帖子列表
`xiaoheihe_game_search`	游戏搜索
`xiaoheihe_game_detail`	游戏基础信息
`xiaoheihe_account_info`	当前登录账号资料和 Steam 绑定
`xiaoheihe_user_profile`	用户完整公开资料
`xiaoheihe_home_feeds`	首页推荐动态（第一页）
`xiaoheihe_home_banner`	首页话题 Banner
`xiaoheihe_game_library`	用户游戏库
`xiaoheihe_notifications`	系统通知
`xiaoheihe_official_messages`	官方消息
`xiaoheihe_discount_messages`	折扣消息摘要
`xiaoheihe_discount_games`	折扣游戏明细
`xiaoheihe_friends`	用户朋友列表
`xiaoheihe_following`	用户关注列表
`xiaoheihe_topic_categories`	话题分类和推荐话题
`xiaoheihe_topic_feeds`	按 topic_id 获取话题动态
`xiaoheihe_news_feeds`	新闻流
`xiaoheihe_game_comments`	游戏社区评论
`xiaoheihe_hot_news`	热点新闻
`xiaoheihe_hot_searches`	热搜词与热门话题
`xiaoheihe_login_status`	查看本地登录态摘要
`xiaoheihe_import_har_login`	从个人 HAR 导入登录态

通用帖子搜索偶发会触发平台验证码；此时请改用 xiaoheihe_topic_search / xiaoheihe_topic_posts 或 xiaoheihe_game_search，稍后再试 xiaoheihe_search。

CLI

.venv/bin/xiaoheihe search "原神"
.venv/bin/xiaoheihe post 191659057
.venv/bin/xiaoheihe topic "原神"
.venv/bin/xiaoheihe topic-posts "原神"
.venv/bin/xiaoheihe game "原神"
.venv/bin/xiaoheihe game-detail 99924346
.venv/bin/xiaoheihe account-info
.venv/bin/xiaoheihe user-profile 123456789
.venv/bin/xiaoheihe home-feeds
.venv/bin/xiaoheihe home-banner
.venv/bin/xiaoheihe game-library 123456789
.venv/bin/xiaoheihe notifications
.venv/bin/xiaoheihe official-messages
.venv/bin/xiaoheihe discount-messages
.venv/bin/xiaoheihe discount-games
.venv/bin/xiaoheihe friends 123456789
.venv/bin/xiaoheihe following 123456789
.venv/bin/xiaoheihe topic-categories
.venv/bin/xiaoheihe topic-feeds 68834
.venv/bin/xiaoheihe news-feeds
.venv/bin/xiaoheihe game-comments 99924346
.venv/bin/xiaoheihe news
.venv/bin/xiaoheihe hot

Signer

本仓库不包含签名算法实现。签名器以外部命令方式提供，你需要自行实现或获取。

技术细节和逆向分析请参考 blog/signing-implementation.md。

外部签名器接受以下命令行参数：

signer <path> <timestamp> <identity> <device> <os-version> <app-version> <imei> <security-code> <security-version>

输出 JSON（stdout 最后一行）：

{
  "path": "/api/endpoint/",
  "_time": "1700000000",
  "nonce": "随机32字符",
  "hkey": "8位签名",
  "_rnd": "前缀:签名值"
}

配置方式（环境变量或 ~/.xiaoheihe-mcp/config.json）：

{
  "signer_command": "/path/to/your/signer",
  "native_signer": true,
  "app_version": "1.3.398",
  "build": "1142",
  "native_identity": "123",
  "native_device": "<device-model>",
  "native_os_version": "15"
}

环境变量：

XIAOHEIHE_SIGNER_COMMAND — 外部签名器路径
XIAOHEIHE_NATIVE_SIGNER=0 — 关闭签名（公开接口回退无签名请求）
XIAOHEIHE_NATIVE_IDENTITY
XIAOHEIHE_NATIVE_DEVICE
XIAOHEIHE_NATIVE_OS_VERSION
XIAOHEIHE_SECURITY_CODE
XIAOHEIHE_SECURITY_VERSION

配置

公开浏览默认无需登录。已登录能力，可在 ~/.xiaoheihe-mcp/config.json 放置：

{
  "heybox_id": "你的 heybox_id",
  "user_pkey": "你的 Cookie pkey"
}

请勿提交 Cookie。当前项目不会将其用于任何写操作。

本项目仅用于个人学习、研究与兼容性分析，不代表平台授权。请遵守平台条款、当地法律，并只访问自己有权访问的数据。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Related MCP Connectors

UsageMax public observability A
io.github.SYMBaiEX
Read-only MCP for AI usage profiles, leaderboards, stats, and docs; no writes or private data.
AI & Machine Learning Observability
41
https://usagemax.com/mcp
KrystalView Analytics A
io.github.KrystalView
Read-only MCP access to sessions, funnels, campaigns, errors, live visitors, and anomalies.
Monitoring Observability
132
https://krystalview.com/mcp
Communicate Developer Docs A
io.github.uditgoenka
Read-only access to Communicate developer guides, OpenAPI summaries, and support contact.
Documentation Access Developer Tools
31
https://communicate.so/mcp
InfluSense AIOAuth
io.github.Case-resolve-tech
Read-only access to InfluSense influencer discovery, ratings, watchlists, and reports via MCP.
Marketing Social Media
1
https://mcp.influsense.tech/mcp

Related MCP Servers

appstoreconnect-codex-mcp
Developer Tools Monitoring
AI-Scarlett
A
license
Not graded
quality
C
maintenance
Enables read-only interaction with App Store Connect via MCP tools, including listing apps, versions, builds, and review submissions, with compliance boundaries and no write operations by default.
Updated 5 months ago (2026-06-04 08:20 UTC)
MIT
reddit-monitor-mcp
Social Media Marketing Research & Data
goonhammer69
F
license
B
quality
C
maintenance
Enables read-only monitoring of Reddit accounts and subreddits, including inbox, post performance, visibility checks, search, analytics, and market scans via MCP tools.
Updated 2 months ago (2026-08-29 01:26 UTC)
18
-
datum-api
Data Platforms Databases
DatumLabMHQ
F
license
Not graded
quality
C
maintenance
Enables read-only access to curated Datum data platform marts, including products, resources, consensus questions, and health metrics, through MCP tools such as list_products, list_questions, ask, query, and health.
Updated a month ago (2026-09-26 23:21 UTC)
1 npm
-
Jira MCP
Project Management Developer Tools
sabrinabettini
A
license
Not graded
quality
B
maintenance
Enables read-only retrieval of Jira Cloud issues, JQL search, and project issue listing through MCP tools.
Updated 2 months ago (2026-09-07 05:59 UTC)
541 npm
MIT

xiaoheihe-mcp

安装

MCP 配置

Tools

CLI

Signer

登录

配置

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

appstoreconnect-codex-mcp

reddit-monitor-mcp

datum-api

Jira MCP