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

> CN Internet Theories / 中文互联网理论库 is an open-source MCP server for news and media. Sourced catalog of viral Chinese-internet theories, searchable in Chinese and English. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://grokkkkkk.github.io/cn-theories/
- **Repository:** https://github.com/grokkkkkk/cn-theories/tree/HEAD/mcp
- **MCP Registry name:** io.github.grokkkkkk/cn-theories
- **Categories:** news and media, knowledge and memory
- **Listing updated:** 2026-11-15

## About

Chinese social media coins short "theories" that spread as memes, and this server lets an assistant look them up with provenance. Entries such as the Big Water Theory, the Lean Muscle Theory or iPhone vs Android Relativity each carry sources, the original quote and summaries in both Chinese and English. The README example shows the Big Water Theory with its alias, first-viral date of 2026-10-05, a short summary and the line it is known for.

Four tools cover keyword search, a full entry (optionally with its Markdown write-up), browsing by year, generation or tag, and the latest entries. Each takes a lang setting of zh, en or both. Two resources expose the full dataset and single entries.

At run time it reads the newest data/theories.json from GitHub, cached for 10 minutes, and falls back to the bundled copy offline or when CN_THEORIES_OFFLINE=1 is set. Code is MIT; data and text are CC BY-SA 4.0. It needs Node.js 18 or later.

## Features

- **Bilingual entries:** Summaries and quotes in Chinese and English, selectable per call.
- **Sourced theories:** Each entry cites where the theory came from.
- **Several ways to browse:** Search, open one entry, filter by year, generation or tag, or list the latest.
- **Live data:** Reads the current dataset from GitHub with a 10-minute cache.
- **Offline mode:** Uses bundled data when GitHub is unreachable or you ask it to.

## Good for

- Explain a meme-theory you saw on Chinese social media
- Find which theories went viral most recently
- Cite the original quote and source for a trend
- Study how internet slang spread, by year or tag

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cn-theories": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cn-theories-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `search_theories`: Keyword search in Chinese or English.
- `get_theory`: One theory in full, optionally with its Markdown write-up.
- `list_theories`: Browse by year, generation or tag.
- `latest_theories`: The most recently viral theories.

## FAQ

### What languages does it return?

Chinese, English or both, set with the lang option.

### Does it need internet?

It reads GitHub for fresh data but falls back to the bundled copy offline.

### What licence applies?

Code is MIT; data and text are CC BY-SA 4.0.

### What do I need to run it?

Node.js 18 or later, started with npx -y cn-theories-mcp.

### Is CN Internet Theories / 中文互联网理论库 free?

Yes. CN Internet Theories / 中文互联网理论库 is open source, so you can use and self-host it for free.

### How do I add CN Internet Theories / 中文互联网理论库 to Claude Code?

Run this command in your terminal: claude mcp add cn-theories -- npx -y cn-theories-mcp

### What are the best alternatives to CN Internet Theories / 中文互联网理论库?

The closest alternatives to CN Internet Theories / 中文互联网理论库 are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/cn-internet-theories
