神岛数据统计 MCP 服务器
基于 Model Context Protocol (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, 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 端点，请按照以下步骤操作：
- 在
src/types/index.ts中添加新的类型定义（如需要） - 对于公开 API，在
src/tools/publicTools.ts中添加新的工具定义 - 对于需要认证的 API，根据其类别在
src/tools/auth/目录下的相应文件中添加新的工具定义