神岛地图数据统计
About
神岛地图数据统计是一个基于 Model Context Protocol (MCP) 的服务器，提供对神岛平台用户数据、地图信息和统计数据的访问。它面向需要集成神岛数据分析功能的开发者。
Details
- Author
- box3lab
- Downloads
- 267
- Categories
- Other
Jump to
- 公开API无需认证访问基础数据
- 认证API需Token访问高级统计
- 完整TypeScript类型定义提供类型安全
- 模块化设计代码清晰易维护
- 标准MCP接口易于集成
- 支持地图玩家留存与行为分析
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
神岛地图数据统计Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
使用 MCP 客户端连接服务器，通过调用特定工具获取数据。公开 API 无需认证直接调用，认证 API 需要在参数中传入 token 和 userAgent。启动命令示例：npx -y @smithery/cli@latest run @dao3fun/statistics-mcp。
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\u795e\u5c9b\u5730\u56fe\u6570\u636e\u7edf\u8ba1": {
"\u795e\u5c9b\u5730\u56fe\u6570\u636e\u7edf\u8ba1": {
"command": "npx",
"args": [
"-y",
"@smithery/cli@latest",
"run",
"@dao3fun/statistics-mcp"
]
}
}
}
}McpServers
{
"\u795e\u5c9b\u5730\u56fe\u6570\u636e\u7edf\u8ba1": {
"command": "npx",
"args": [
"-y",
"@smithery/cli@latest",
"run",
"@dao3fun/statistics-mcp"
]
}
}神岛数据统计 MCP 服务器
基于 Model Context Protocol (MCP) 的服务器，提供对神岛平台用户数据、地图信息和统计数据的访问。
功能特点
- 公开 API: 无需认证访问的基础数据（用户资料、地图详情、评论列表）
- 认证 API: 需要 Token 访问的高级数据（用户评论、各类统计数据）
- 地图分析: 全面的地图玩家数据、留存率、行为分析等
- 类型安全: 完整的 TypeScript 类型定义，提供代码提示和错误检查
- 模块化设计: 清晰的代码结构，易于维护和扩展
- 标准接口: 基于 MCP 协议，提供标准化的工具接口
- 易于集成: 支持多平台客户端集成，包括浏览器、CLI 等
可用工具
公开 API (无需认证)
| 工具名称 | 描述 | 参数 |
| ------------------- | -------------------------- | -------------------------------------------------------- |
| getUserProfile | 获取用户个人资料 | userId |
| getMapInfo | 获取地图详情信息 | mapId |
| getMapCommentList | 获取地图评论列表 | contentId, limit, offset, orderBy, contentType |
| getMapReleaseInfo | 获取地图发布信息 | contentId, limit, offset |
| getMapList | 通过模糊关键字获取地图列表 | keyword, limit, offset ,orderBy |
需要认证的 API
| 工具名称 | 描述 | 参数 |
| ----------------------- | ---------------- | ----------------------------------------------------- |
| getCommentList | 获取用户评论列表 | 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工具
│ └── 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
- Model Context Protocol (MCP)
- Zod (类型验证)
- Axios (HTTP 请求)
许可证
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
