<div align="center">

🔥 Pulse CN MCP Server

一个强大的模型上下文协议（MCP）服务器，提供来自中国互联网的实时热门内容。

功能 • 安装 • 快速开始 • 文档 • 贡献 • 许可证

</div>

🌟 概览

Pulse CN MCP 服务器使 AI 模型能够访问有关中国互联网上最新趋势的信息。它基于模型上下文协议（MCP）构建，充当 AI 模型与来自中国最流行的社交媒体平台、新闻网站和内容聚合器的实时数据之间的桥梁。

✨ 功能

该服务器提供了来自 18 个主要中文平台的实时趋势数据访问：

🚀 安装

# 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

⚡ 快速开始

使用以下命令启动 MCP 服务器：

# Using npm
npm start

# Or using Bun
bun start

这将使用 Stdio 传输方式启动服务器，使其准备好供兼容 MCP 的 AI 模型连接。

📖 文档

架构

Pulse CN MCP 服务器遵循模块化架构，每个数据源都有单独的工具：

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

可用工具

已完全实现

即将推出

• 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

集成示例

这里是使用 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);
}

🛠️ 开发

添加新工具

1. 在 src/tools/ 目录下创建一个新文件（例如 myNewTool.ts）
2. 使用 MCP Server SDK 实现您的工具
3. 在 src/index.ts 中注册该工具

示例：

// 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);

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

1. 分叉项目
2. 创建你的特性分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

📄 许可证

本项目根据 MIT 许可证发布 - 查看 LICENSE 文件获取详细信息。

🙏 致谢

本项目利用了由韩小韩API提供的免费 API。我们对其出色的服务和支持表示衷心的感谢。

---

<div align="center"> _{由 wangtsiao 用 ❤️ 构建} </div>