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

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:

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

Cursor — ~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）:

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

Claude Code:

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

ツール / Tools

ツール Tool	パラメーター Arguments	機能 What it does
search_theories	query, lang?, limit?	中国語または英語のキーワードで検索（名称、別名、タグ、提唱者、概要、原文）/ Keyword search in Chinese or English
get_theory	id_or_name, include_markdown?, lang?	理論の意味、出典、原文を確認。完全な項目を含めることもできます / One entry in full, optionally with its markdown write-up
list_theories	year?, generation?, tag?, lang?	年、世代、タグで一覧表示 / Browse by year, generation or tag
latest_theories	limit?, 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	カスタムデータ URL / Custom raw base URL

開発 / Development

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

ライセンス / License

コード：MIT。データと文章：CC BY-SA 4.0。Code: MIT. Data and text: CC BY-SA 4.0. See LICENSE.