神秘岛屿数据统计MCP服务器

基于模型上下文协议（MCP）的服务器，提供对神秘岛屿平台上用户数据、地图信息及统计数据的访问。

特性

• 公共API无需身份验证的基本数据访问（用户概况、地图详情、评论列表）
• 认证API需要Token访问的高级数据（用户评论、各种统计数据）
• 地图分析全面的地图玩家数据、留存率、行为分析等
• 模块化设计清晰的代码结构，易于维护和扩展
• 易于集成支持多平台客户端集成，包括浏览器、CLI等

可用工具

公共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, sEndTime, 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/ 目录下的相应文件中添加新的工具定义