MCP ExplorerExplorer

Mcp Weibohot Server

@wangtsiaoon 5 days ago
3ย MIT
FreeCommunity
AI Systems

Overview

What is Mcp Weibohot Server

The Pulse CN MCP Server is a Model Context Protocol (MCP) server designed to provide real-time access to trending data from various popular platforms across the Chinese internet. It serves as an interface between AI models and up-to-date content, allowing for dynamic and relevant information retrieval.

Use cases

This server can be utilized by AI models to access and integrate real-time trending topics such as social media buzz, news headlines, horoscopes, and motivational quotes. This integration can enhance applications in areas like content generation, sentiment analysis, and personalized recommendations.

How to use

To use the Pulse CN MCP Server, first clone the repository and install the dependencies using npm or Bun. Start the server with the provided commands. Once running, connect your AI model to the server and call the appropriate tools via predefined endpoints to access trending content.

Key features

The server offers access to real-time data from 18 major Chinese platforms, including Weibo, Zhihu, and Baidu, among others. It provides tools for areas such as trending topics, daily horoscope predictions, and aggregated news, with several tools fully implemented and more in development.

Where to use

The server is suitable for applications that require real-time insights from the Chinese internet, including chatbot development, recommendation systems, and any AI model that benefits from current trends in social media, news, and popular culture.

Content

๐Ÿ”ฅ Pulse CN MCP Server

License: MIT
TypeScript
smithery badge
PRs Welcome

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

  1. Create a new file in src/tools/ (e.g., myNewTool.ts)
  2. Implement your tool using the MCP Server SDK
  3. 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.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. 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

Tools

No tools

Comments