Weibo Hot

🚀 Project Introduction

This is an open - source project written in TypeScript, aiming to provide various functional modules through the Model Context Protocol (MCP).

🚀 Quick Start

After starting the project, access the following interfaces:

Basic Usage

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

async function example() {
  const client = new McpClient();
  
  // Get real - time hot ranking
  const realtimeHotRanking = await client.callTool("realtime - hot - ranking", {});
  console.log(realtimeHotRanking.content);
  
  // Get daily hot ranking
  const dailyHotRanking = await client.callTool("daily - hot - ranking", {});
  console.log(dailyHotRanking.content);

  // Query historical data (past 7 days)
  const historyData = await client.callTool("history - data", { days: 7 });
  console.log(historyData.content);
}

✨ Features

Implemented Features

• Real - time Hot Ranking: Retrieve current real - time hot information.
• Daily Hot Ranking: Display the day's popular list.
• Historical Data Query: Support viewing historical records within the past 7 days.
• Personalized Recommendation: Provide customized content based on user interests.

Features in Development

• User feedback analysis system
• Optimization of intelligent recommendation algorithms
• Multi - platform data synchronization
• Data statistics and visualization

📦 Installation

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

3. Start the service:

   npm run dev
   

📚 Documentation

Adding New Functional Modules

1. Create a new file in the src/tools/ directory (e.g., newFeature.ts).

2. Implement a new tool module:

// 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",
    "New feature description",
    {
      param1: z.string().describe("Parameter description")
    },
    async (params) => {
      // Implement new feature logic
      return {
        content: [
          { type: "text", text: "Example return result" }
        ]
      };
    }
  );
}

3. Register the new tool in src/index.ts:

import { registerNewFeature } from './tools/newFeature.js';
// Register the new tool
registerNewFeature(server);

🤝 Contribution Guidelines

Contributions are welcome! Please follow these steps:

1. Fork the project repository:

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

2. Create a feature branch:

   git checkout -b feature/amazing-feature
   

3. Commit your changes:

   git add .
   git commit -m 'Add amazing feature'
   

4. Push the branch:

   git push origin feature/amazing-feature
   

5. Submit a Pull Request.

📄 License

This project uses the MIT license. Please refer to the LICENSE file for specific details.

🙏 Acknowledgments

Thanks to Han Xiaohan API for providing free interface support!