Statistics MCP

🚀 Shendao Data Statistics MCP Server

A server based on the Model Context Protocol (MCP) that provides access to user data, map information, and statistical data on the Shendao platform.

🚀 Quick Start

This server, built upon the Model Context Protocol (MCP), offers access to user data, map information, and statistical data on the Shendao platform.

✨ Features

• Public APIs: Access basic data (user profiles, map details, comment lists) without authentication.
• Authenticated APIs: Access advanced data (user comments, various statistical data) with a token.
• Map Analysis: Comprehensive analysis of map player data, retention rates, behavior analysis, etc.
• Type Safety: Complete TypeScript type definitions for code hints and error checking.
• Modular Design: Clear code structure for easy maintenance and expansion.
• Standard Interfaces: Provide standardized tool interfaces based on the MCP protocol.
• Easy Integration: Support integration with multi - platform clients, including browsers and CLIs.

📦 Available Tools

Public APIs (No Authentication Required)

Authenticated APIs (Token Required)

💻 Usage Examples

Public API Example

// Get user profile
const userProfile = await getUserProfile(userId);

Authenticated API Example

// Get map statistical data
const mapStats = await getMapStats(mapId, 'daily');

📚 Documentation

Project Structure

├── index.ts                # Main entry file
├── src/                    # Source code directory
│   ├── types/              # Type definitions
│   │   └── index.ts        # Shared type definitions
│   ├── utils/              # Utility functions
│   │   └── api.ts          # API request utility
│   └── tools/              # MCP tool implementations
│       ├── publicTools.ts  # Public API tools
│       └── authTools.ts    # Authenticated API tools
├── package.json            # Project configuration and dependencies
├── tsconfig.json           # TypeScript configuration
└── README.md               # Project documentation

Adding New API Endpoints

To add new API endpoints, follow these steps:

1. Add new type definitions in src/types/index.ts if necessary.
2. For public APIs, add new tool definitions in src/tools/publicTools.ts.
3. For authenticated APIs, add new tool definitions in src/tools/authTools.ts.

🔧 Technical Details

• TypeScript
• Model Context Protocol (MCP)
• Zod (Type Validation)
• Axios (HTTP Requests)

📄 License

MIT