🚀 项目说明

这是一个使用TypeScript编写的开源项目，通过Model Context Protocol（MCP）提供多种功能模块，能满足用户对热点信息获取、历史数据查询等多方面的需求。

🚀 快速开始

项目启动后，可访问以下接口来体验功能。示例代码如下：

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

async function example() {
  const client = new McpClient();
  
  // 获取实时热搜榜
  const realtimeHotRanking = await client.callTool("realtime-hot-ranking", {});
  console.log(realtimeHotRanking.content);
  
  // 获取每日热榜
  const dailyHotRanking = await client.callTool("daily-hot-ranking", {});
  console.log(dailyHotRanking.content);

  // 查询历史数据（过去7天）
  const historyData = await client.callTool("history-data", { days: 7 });
  console.log(historyData.content);
}

✨ 主要特性

已实现功能

• 实时热搜榜：获取当前实时热点信息
• 每日热榜：展示当天的热门榜单
• 历史数据查询：支持查看过去7天内的历史记录
• 个性化推荐：根据用户兴趣提供定制化内容

开发中功能

• 用户反馈分析系统
• 智能推荐算法优化
• 多平台数据同步
• 数据统计与可视化

📦 安装指南

1. 克隆仓库：

   git clone https://github.com/wangtsiao/your-project.git
   cd your-project
   

2. 安装依赖：

   npm install
   

3. 启动服务：

   npm run dev
   

📚 详细文档

添加新功能模块

1. 在src/tools/目录下创建新文件（例如：newFeature.ts）
2. 实现新的工具模块：

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

export function registerNewFeature(server: McpServer) {
  server.tool(
    "new-feature",
    "新功能描述",
    {
      param1: z.string().describe("参数说明")
    },
    async (params) => {
      // 实现新功能逻辑
      return {
        content: [
          { type: "text", text: "返回结果示例" }
        ]
      };
    }
  );
}

3. 在src/index.ts中注册新工具：

import { registerNewFeature } from './tools/newFeature.js';
// 注册新工具
registerNewFeature(server);

🤝 贡献指南

欢迎贡献！请按照以下步骤进行：

1. 叉取项目仓库：

   git fork https://github.com/wangtsiao/your-project.git
   

2. 创建功能分支：

   git checkout -b feature/amazing-feature
   

3. 提交修改：

   git add .
   git commit -m '添加神奇功能'
   

4. 推送分支：

   git push origin feature/amazing-feature
   

5. 提交Pull Request

📄 许可证

本项目使用MIT许可证，具体内容请参阅LICENSE文件。

🙏 致谢

感谢韩小韩API提供的免费接口支持！