Statistics MCP

🚀 神島數據統計 MCP 服務器

本服務器基於 Model Context Protocol (MCP) 構建，可提供對神島平臺用戶數據、地圖信息和統計數據的訪問，為開發者提供便捷的數據獲取途徑。

🚀 快速開始

基於 Model Context Protocol (MCP) 的服務器，提供對神島平臺用戶數據、地圖信息和統計數據的訪問。你可以通過公開 API 訪問基礎數據，也能使用認證 API 獲取高級數據。

✨ 主要特性

• 公開 API：無需認證即可訪問基礎數據，如用戶資料、地圖詳情、評論列表等。
• 認證 API：需使用 Token 訪問高級數據，例如用戶評論、各類統計數據。
• 地圖分析：提供全面的地圖玩家數據、留存率、行為分析等。
• 類型安全：具備完整的 TypeScript 類型定義，可提供代碼提示和錯誤檢查。
• 模塊化設計：代碼結構清晰，便於維護和擴展。
• 標準接口：基於 MCP 協議，提供標準化的工具接口。
• 易於集成：支持多平臺客戶端集成，涵蓋瀏覽器、CLI 等。

📦 安裝指南

文檔未提供安裝步驟，暫不展示。

💻 使用示例

基礎用法

// 獲取用戶資料
const userProfile = await getUserProfile(userId);

高級用法

// 獲取地圖統計數據
const mapStats = await getMapStats(mapId, 'daily');

📚 詳細文檔

可用工具

公開 API (無需認證)

需要認證的 API (需要 Token)

項目結構

├── index.ts                # 主入口文件
├── src/                    # 源代碼目錄
│   ├── types/              # 類型定義
│   │   └── index.ts        # 共享類型定義
│   ├── utils/              # 工具函數
│   │   └── api.ts          # API 請求工具
│   └── tools/              # MCP 工具實現
│       ├── publicTools.ts  # 公開 API 工具
│       └── authTools.ts    # 需要認證的 API 工具
├── package.json            # 項目配置和依賴
├── tsconfig.json           # TypeScript 配置
└── README.md               # 項目文檔

添加新的 API 端點

要添加新的 API 端點，請按照以下步驟操作：

1. 在 src/types/index.ts 中添加新的類型定義（如需要）。
2. 對於公開 API，在 src/tools/publicTools.ts 中添加新的工具定義。
3. 對於需要認證的 API，在 src/tools/authTools.ts 中添加新的工具定義。

🔧 技術細節

本項目使用的技術棧如下：

• TypeScript
• 模型上下文協議 (MCP)
• Zod (類型驗證)
• Axios (HTTP 請求)

📄 許可證

本項目採用 MIT 許可證。