CN Internet Theories / 中文互联网理论库

io.github.grokkkkkkPublished by GitHub account grokkkkkkv0.1.0Updated Oct 24, 2026

Search viral Chinese-internet theories (大水理论, 薄肌理论…) with sources, in Chinese and English.

VerifiedSTDIODesktop onlyWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Lets an assistant search and read a sourced catalog of viral Chinese-internet "theories", with original quotes and Chinese/English summaries.

What you can do
  • Search theories by keyword in Chinese or English, across names, aliases, tags, originators and quotes
  • Read a single entry in full, including meaning, sources and original quote, optionally with its markdown write-up
  • Browse entries by year, generation or tag
  • List the most recently viral theories
  • Expose the full dataset and per-entry markdown as resources
When to use it
Useful when you want an assistant to explain or look up Chinese-internet slang and viral "theories" with citations, for example when writing about online culture or answering what a term like 大水理论 means.
Requirements
Runs locally over stdio via npx, so Node.js 18+ is needed. No account or API key. It fetches the latest dataset from GitHub at runtime, falling back to the bundled copy; CN_THEORIES_OFFLINE=1 forces bundled-only use, and CN_THEORIES_BRANCH and CN_THEORIES_RAW_BASE change the data source.
Before you install
By default it contacts GitHub at runtime to read the dataset, so queries and usage timing leave the machine; set CN_THEORIES_OFFLINE=1 to stay local. Pointing CN_THEORIES_RAW_BASE at a custom address means trusting that source. Content is third-party internet material and should be checked against the cited sources.

Installation

In SourceWeft

  1. Open CN Internet Theories / 中文互联网理论库 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

cn-theories-mcp

中文互联网理论库的 MCP 服务器。让 Claude、Cursor 等 AI 助手直接查询 cn-theories 收录的网络“理论”：大水理论、薄肌理论、黄毛思维、苹果安卓相对论……每条都带出处、原话和中英文简介。

An MCP server for cn-theories, a sourced catalog of viral Chinese-internet "theories" (The Big Water Theory, The Lean Muscle Theory, iPhone vs Android Relativity…). Every entry has sources, the original quote, and summaries in Chinese and English.

安装 / Install

需要 Node.js 18+。Requires Node.js 18+.

Claude Desktop — claude_desktop_config.json:

json
{  "mcpServers": {    "cn-theories": {      "command": "npx",      "args": ["-y", "cn-theories-mcp"]    }  }}

Cursor — ~/.cursor/mcp.json（或项目里的 .cursor/mcp.json）:

json
{  "mcpServers": {    "cn-theories": {      "command": "npx",      "args": ["-y", "cn-theories-mcp"]    }  }}

Claude Code:

bash
claude mcp add cn-theories -- npx -y cn-theories-mcp

工具 / Tools

工具 Tool参数 Arguments作用 What it does
search_theoriesquery, lang?, limit?按中英文关键词搜索（名称、别名、标签、提出者、简介、原话）/ Keyword search in Chinese or English
get_theoryid_or_name, include_markdown?, lang?查看一条理论的含义、出处、原话；可附带完整条目 / One entry in full, optionally with its markdown write-up
list_theoriesyear?, generation?, tag?, lang?按年份、批次、标签列出 / Browse by year, generation or tag
latest_theorieslimit?, lang?最近走红的理论 / Most recently viral theories

lang 可选 zh、en、both（默认）。lang is zh, en or both (default).

资源 / Resources:

  • cn-theories://theories.json：完整数据集 / the full dataset
  • cn-theories://theory/{id}：单条理论的 Markdown 全文 / one entry's markdown

示例 / Example

大水理论是什么？/ What is the Big Water Theory?

## 大水理论 / The Big Water Theory- **ID**: dashui-lilun- **别名 / Aliases**: 喝大水- **首次走红 / First viral**: 2026-10-05- **简介**: 奶茶戒了，拎一瓶两升的白开水出门。- **Summary**: Ditch the bubble tea. Carry a 2-liter bottle of water instead.- **原话**: “弱者喝饮料，强者喝大水。”...

数据 / Data

服务器运行时读取 GitHub 上最新的 data/theories.json（缓存 10 分钟），所以仓库一更新，查到的内容就跟着更新。网络不通时使用安装包里自带的那份。

At runtime the server reads the latest data/theories.json from GitHub (cached for 10 minutes), so new entries show up as soon as the repo is updated. If GitHub can't be reached, it falls back to the copy bundled in the package.

环境变量 Env var作用 Effect
CN_THEORIES_OFFLINE=1只用自带数据，不联网 / Use bundled data only
CN_THEORIES_BRANCH读取的分支，默认 main / Branch to read (default main)
CN_THEORIES_RAW_BASE自定义数据地址 / Custom raw base URL

开发 / Development

bash
npm installnpm run build   # 同步 ../data 与 ../theories 到 data/，然后编译 / syncs data, then compilesnpm test        # 用官方 SDK 客户端调用所有工具 / calls every tool via the SDK clientOFFLINE=1 npm test

许可 / License

代码 MIT；数据与文字 CC BY-SA 4.0。Code: MIT. Data and text: CC BY-SA 4.0. See LICENSE.

Source: mcp/README.md at commit bc5bb18

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestOct 15, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.