🔥 Pulse CN MCP Server

A powerful Model Context Protocol (MCP) server providing real-time trending content from the Chinese internet.

Features • Installation • Quick Start • Documentation • Contributing • License

🌟 Overview

Pulse CN MCP Server enables AI models to access up-to-date information about what's trending on the Chinese internet. Built with the Model Context Protocol (MCP), it acts as a bridge between AI models and real-time data from China's most popular social media platforms, news sites, and content aggregators.

✨ Features

The server provides real-time access to trending data from 18 major Chinese platforms:

Platform	Content	Status
🔮 星座运势	Daily horoscope predictions	✅
💬 每日一句励志英语	Daily motivational English quotes	✅
📊 热搜热榜聚合	Aggregated trending topics	✅
🔥 微博实时热搜	Weibo real-time trending topics	✅
📰 今日头条热搜	Today's Headlines trending news	✅
📝 澎湃新闻热搜	ThePaper.cn news trending topics	✅
🏀 虎扑步行街热搜	Hupu BXJ real-time trends	🔜
❓ 知乎实时热搜	Zhihu real-time trending topics	🔜
📔 知乎每日日报	Zhihu daily digest	🔜
💼 36氪24小时热榜	36Kr 24-hour trending business news	🔜
🎬 哔哩哔哩全站日榜	Bilibili daily rankings	🔜
🔍 百度热点热榜	Baidu trending topics	🔜
📱 抖音热点热榜	Douyin trending topics	🔜
👥 豆瓣小组精选	Douban group featured content	🔜
💻 IT资讯热榜	IT news trending topics	🔜
📈 虎嗅网热榜	Huxiu 24-hour trending topics	🔜
📱 产品经理热文榜	Woshipm daily popular articles	🔜
🐞 虫族部落最新热门	Chongbuluo latest popular content	🔜

🚀 Installation

# Clone the repository
git clone https://github.com/wangtsiao/pulse-cn-mcp.git

# Navigate to the project directory
cd pulse-cn-mcp

# Using npm
npm install
npm run build

# Or using Bun (faster)
bun install
bun run build

⚡ Quick Start

Start the MCP server with:

# Using npm
npm start

# Or using Bun
bun start

This launches the server using the Stdio transport, making it ready for MCP-compatible AI models to connect.

📖 Documentation

Architecture

Pulse CN MCP Server follows a modular architecture with individual tools for each data source:

src/
├── index.ts            # Main entry point and server setup
└── tools/              # Individual tool implementations
    ├── weiboHotspots.js
    ├── horoscope.js
    ├── dailyEnglishSentence.js
    ├── internetHotspotsAggregator.js
    ├── todayHeadlinesHotspots.js
    ├── paperNewsHotspots.js
    └── otherHotspots.js

Available Tools

Fully Implemented

Tool Name	Description	Endpoint
`weibo-hotspots`	Real-time trending topics from Weibo	`/weibo-hotspots`
`horoscope`	Daily horoscope by zodiac sign	`/horoscope`
`daily-english-sentence`	Daily motivational English quotes	`/daily-english-sentence`
`internet-hotspots-aggregator`	Aggregated trending topics	`/internet-hotspots-aggregator`
`today-headlines-hotspots`	Today's Headlines trending topics	`/today-headlines-hotspots`
`paper-news-hotspots`	ThePaper.cn trending news	`/paper-news-hotspots`

Coming Soon

hupu-pedestrian-street-hotspots
zhihu-realtime-hotspots
zhihu-daily-hotspots
36-krypton-24-hour-hotspots
bilibili-daily-hotspots
baidu-hotspots
douyin-hotspots
douban-group-hotspots
huxiu-hotspots
product-manager-hotspots
in-information-hotspots
insect-hotspots

Integration Example

Here's how to integrate with the server using TypeScript:

import { McpClient } from "@modelcontextprotocol/sdk/client";

async function example() {
  const client = new McpClient();
  
  // Get Weibo trending topics
  const weiboHotspots = await client.callTool("weibo-hotspots", {});
  console.log(weiboHotspots.content);
  
  // Get daily horoscope for Aries
  const horoscope = await client.callTool("horoscope", { sign: "aries" });
  console.log(horoscope.content);
}

🛠️ Development

Adding a New Tool

Create a new file in src/tools/ (e.g., myNewTool.ts)
Implement your tool using the MCP Server SDK
Register the tool in src/index.ts

Example:

// src/tools/myNewTool.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

export function registerMyNewTool(server: McpServer) {
  server.tool(
    "my-new-tool",
    "Description of my new tool",
    {
      // Tool parameters schema
      param1: z.string().describe("Parameter description")
    },
    async (params) => {
      // Tool implementation
      return {
        content: [
          { type: "text", text: "Result of my tool" }
        ]
      };
    }
  );
}

// src/index.ts - Add import and registration
import { registerMyNewTool } from './tools/myNewTool.js';
// ...
registerMyNewTool(server);

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the project
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

This project utilizes the free APIs provided by 韩小韩API. We express our sincere gratitude for their excellent service and support.

_{Built with ❤️ by wangtsiao}