Skip to main content
Glama
神岛数据统计 MCP 服务器

神岛数据统计 MCP 服务器

by box3lab

神岛数据统计 MCP 服务器

基于 Model Context Protocol (MCP) 的服务器,提供对神岛平台用户数据、地图信息和统计数据的访问。

功能特点

  • 公开 API: 无需认证访问的基础数据(用户资料、地图详情、评论列表)

  • 认证 API: 需要 Token 访问的高级数据(用户评论、各类统计数据)

  • 地图分析: 全面的地图玩家数据、留存率、行为分析等

  • 模块化设计: 清晰的代码结构,易于维护和扩展

  • 易于集成: 支持多平台客户端集成,包括浏览器、CLI 等

Related MCP server: SORACOM Data Reader MCP

可用工具

公开 API (无需认证)

工具名称

描述

参数

getUserProfileByUserId

获取用户个人资料

userId

getMapInfoByUserId

获取地图详情信息

mapId

getMapCommentListByUserId

获取地图评论列表

contentId, limit, offset, orderBy, contentType

getMapReleaseInfoByUserId

获取地图发布信息

contentId, limit, offset

getMapListByUserId

获取用户地图列表

userId, limit, offset

getModelListByUserId

获取用户模型列表

userId, limit, offset

getFavoriteListByUserId

获取用户收藏列表

userId, limit, offset, contentType

getRecentlyPlayListByUserId

获取用户最近游玩列表

userId, limit, offset

getFollowerListByUserId

获取用户粉丝列表

userId, limit, offset

getFriendListByUserId

获取用户好友列表

userId, limit, offset

getFollowingListByUserId

获取用户关注列表

userId, limit, offset

getMapListByKeyword

通过关键字搜索地图/模型

keyword, limit, offset, orderBy

需要认证的 API

工具名称

描述

参数

getCommentList

获取用户评论列表

offset, limit, token, userAgent

getLikeList

获取用户点赞列表

offset, limit, token, userAgent

getSystemMsgList

获取用户系统消息列表

offset, limit, token, userAgent

getMapStatList

获取地图统计列表

startTime, endTime, token, userAgent

getMapPlayerStatList

获取地图玩家统计

startTime, endTime, mapId, token, userAgent

getMapPlayerRetention

获取地图玩家留存

startTime, endTime, mapId, token, userAgent

getMapPlayerBehavior

获取地图玩家行为

startTime, endTime, mapId, token, userAgent

客户端示例

公开 API 调用示例

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

// 创建传输通道
const transport = new StdioClientTransport({
  command: "npx",
  args: ["-y", "@smithery/cli@latest", "run", "@dao3fun/statistics-mcp"],
});

// 初始化客户端
const client = new Client(
  { name: "dao3-client", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

// 连接到服务器
await client.connect(transport);

// 获取用户资料 (公开API)
const userProfile = await client.callTool({
  name: "getUserProfile",
  arguments: { userId: "83354" },
});

// 获取地图详情 (公开API)
const mapInfo = await client.callTool({
  name: "getMapInfo",
  arguments: { mapId: "100131463" },
});

console.log(JSON.parse(userProfile.content[0].text));

需要认证的 API 调用示例

// 认证信息
const token = "YOUR_TOKEN";
const userAgent = "Mozilla/5.0 ...";

// 获取地图统计数据 (需要认证)
const mapStats = await client.callTool({
  name: "getMapStatList",
  arguments: {
    startTime: "2025-03-29",
    endTime: "2025-04-04",
    token,
    userAgent,
  },
});

// 获取地图玩家留存率 (需要认证)
const retention = await client.callTool({
  name: "getMapPlayerRetention",
  arguments: {
    startTime: "2025-03-29",
    endTime: "2025-04-04",
    mapId: "100131463",
    token,
    userAgent,
  },
});

// 处理响应
const statsData = JSON.parse(mapStats.content[0].text);

项目结构

├── index.ts                # 主入口文件
├── src/                    # 源代码目录
│   ├── types/              # 类型定义
│   │   └── index.ts        # 共享类型定义
│   ├── utils/              # 工具函数
│   │   └── api.ts          # API请求工具
│   └── tools/              # MCP工具实现
│       ├── publicTools.ts  # 公开API工具
│       └── auth/           # 需要认证的API工具
│           ├── index.ts
│           ├── auth_msgTools.ts
│           └── auth_statsTools.ts
├── package.json            # 项目配置和依赖
├── tsconfig.json           # TypeScript配置
└── README.md               # 项目文档

添加新的 API 端点

要添加新的 API 端点,请按照以下步骤操作:

  1. 在 src/types/index.ts 中添加新的类型定义(如需要)

  2. 对于公开 API,在 src/tools/publicTools.ts 中添加新的工具定义

  3. 对于需要认证的 API,根据其类别在 src/tools/auth/ 目录下的相应文件中添加新的工具定义

Available Tools

19 tools
getCommentListC

获取神岛平台用户的评论列表,需要Token和用户请求头

Inputs: limit (required), token (required), offset (required), userAgent (required).

getFavoriteListByUserIdB

使用用户ID获取神岛平台收藏列表

Inputs: limit (required), offset (required), userId (required), contentType (required).

getFollowerListByUserIdA

使用用户ID获取神岛平台粉丝列表

Inputs: limit (required), offset (required), userId (required).

getFollowingListByUserIdA

使用用户ID获取神岛平台关注列表

Inputs: limit (required), offset (required), userId (required).

getFriendListByUserIdA

使用用户ID获取神岛平台好友列表

Inputs: limit (required), offset (required), userId (required).

getLikeListB

获取神岛平台用户的点赞列表,需要Token和用户请求头

Inputs: limit (required), token (required), offset (required), userAgent (required).

getMapCommentListByUserIdC

使用地图ID获取神岛平台地图评论列表

Inputs: limit (required), offset (required), orderBy (required), contentId (required), +1 more.

getMapInfoByUserIdC

使用地图ID获取神岛平台地图详情

Inputs: mapId (required).

getMapListByKeywordC

使用关键字搜索获取神岛平台地图/模型列表

Inputs: limit (required), offset (required), keyword (required), orderBy (required).

getMapListByUserIdB

使用用户ID获取神岛平台地图列表

Inputs: limit (required), offset (required), userId (required).

getMapPlayerBehaviorC

获取神岛平台用户地图玩家行为,需Token和用户请求头和地图ID

Inputs: mapId (required), token (required), endTime (required), startTime (required), +1 more.

getMapPlayerRetentionC

获取神岛平台用户地图玩家留存,需Token和用户请求头和地图ID

Inputs: mapId (required), token (required), endTime (required), startTime (required), +1 more.

getMapPlayerStatListC

获取神岛平台用户地图玩家统计,需Token和用户请求头和地图ID

Inputs: mapId (required), token (required), endTime (required), startTime (required), +1 more.

getMapReleaseInfoByUserIdC

使用地图ID获取神岛平台地图发布信息

Inputs: limit (required), offset (required), contentId (required).

getMapStatListC

获取神岛平台用户地图统计列表,需Token和用户请求头

Inputs: token (required), endTime (required), startTime (required), userAgent (required).

getModelListByUserIdB

使用用户ID获取神岛平台模型列表

Inputs: limit (required), offset (required), userId (required).

getRecentlyPlayListByUserIdA

使用用户ID获取神岛平台最近游玩列表

Inputs: limit (required), offset (required), userId (required).

getSystemMsgListA

获取神岛平台用户的系统消息列表,需要Token和用户请求头

Inputs: limit (required), token (required), offset (required), userAgent (required).

getUserProfileByUserIdB

使用用户ID获取神岛平台用户的个人资料数据

Inputs: userId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 19 tools

    Disambiguation4/5

    Each tool targets a distinct data entity (map info, comments, lists, stats), but getMapInfoByUserId and getMapReleaseInfoByUserId could be confused, as could getMapCommentListByUserId and getCommentList. Overall, scope is clear.

    Naming Consistency4/5

    All tools use the get prefix and camelCase, generally following get<Resource>By<Parameter>. Some tools like getMapStatList and getMapPlayerStatList deviate from the By pattern, but the naming is still predictable.

    Tool Count3/5

    19 tools is within the 16-25 heavy range; for a data retrieval server this is reasonable, though it could potentially be streamlined.

    Completeness4/5

    Covers user profiles, social lists, map/model data, statistics, and user interactions. Missing model details and leaderboard data, but core statistics workflows are covered.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to NFTGo's Developer API for retrieving NFT collection details, asset information, market data, wallet information, and search capabilities on the Ethereum blockchain.
      13 npm
      5
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides comprehensive geographic information services and route planning for AI agents via the Amap (Gaode Maps) API. It supports geocoding, multi-modal navigation, POI searches, and administrative region queries.
      3
      -
    • A
      license
      A
      quality
      D
      maintenance
      Geospatial API tools for AI agents — geocoding, reverse geocoding, routing, isochrone, distance matrix, static maps, H3 hexagons, elevation, GPS map-matching, point-in-polygon, address normalisation, timezone lookup, and batch geocoding. Built on OpenStreetMap infrastructure. Cost-effective alternative to Google Maps API.
      18
      34 npm
      MIT