{"_id":"@box3lab/statistics-mcp","name":"@box3lab/statistics-mcp","dist-tags":{"latest":"0.0.3"},"versions":{"0.0.3":{"name":"@box3lab/statistics-mcp","version":"0.0.3","description":"神岛平台数据统计MCP服务，提供用户资料、地图信息和统计数据访问","main":"build/index.js","type":"module","scripts":{"publish":"npm publish","start":"node build/index.js","dev":"tsc -w","build":"tsc && chmod 755 build/index.js","clean":"rm -rf build","rebuild":"npm run clean && npm run build"},"keywords":["mcp","神岛","box3lab","statistics","数据统计"],"author":{"name":"box3lab"},"license":"MIT","dependencies":{"@anthropic-ai/sdk":"^0.39.0","@modelcontextprotocol/sdk":"^1.8.0","axios":"^1.8.4","dotenv":"^16.4.7","zod":"^3.22.4"},"devDependencies":{"@types/node":"^22.14.0","typescript":"^5.8.2"},"repository":{"type":"git","url":"git+https://github.com/box3lab/statistics-mcp.git"},"bugs":{"url":"https://github.com/box3lab/statistics-mcp/issues"},"_id":"@box3lab/statistics-mcp@0.0.3","gitHead":"b4afea5bf40a854ea54ca9db550aba37f366867c","homepage":"https://github.com/box3lab/statistics-mcp#readme","_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-jhCnCAOEKFJnawthuNW3yxbpRstNt7N+68ocbpxkEUn5txtUxAKfnimFsjX7Hbop27lLvOftDnBEL9or7fxh8A==","shasum":"4c008851da2fd78facd54958f85bcb5aad59e373","tarball":"https://registry.npmjs.org/@box3lab/statistics-mcp/-/statistics-mcp-0.0.3.tgz","fileCount":15,"unpackedSize":23556,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDQgv5PYt1Vo7iDMHJAo4tjrbsEYYvhCAfWmucm2btMtgIhAKv/WSeIl3TnQl/5qOXoeAZt+KMVDLIucSXAlnC2D/ox"}]},"_npmUser":{"name":"viyrs","email":"2991883280@qq.com"},"directories":{},"maintainers":[{"name":"viyrs","email":"2991883280@qq.com"},{"name":"helloyork","email":"helloyork@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/statistics-mcp_0.0.3_1744271079138_0.7529056156872669"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-10T07:44:39.076Z","0.0.3":"2025-04-10T07:44:39.320Z","modified":"2025-04-10T07:44:39.647Z"},"maintainers":[{"name":"viyrs","email":"2991883280@qq.com"},{"name":"helloyork","email":"helloyork@icloud.com"}],"description":"神岛平台数据统计MCP服务，提供用户资料、地图信息和统计数据访问","homepage":"https://github.com/box3lab/statistics-mcp#readme","keywords":["mcp","神岛","box3lab","statistics","数据统计"],"repository":{"type":"git","url":"git+https://github.com/box3lab/statistics-mcp.git"},"author":{"name":"box3lab"},"bugs":{"url":"https://github.com/box3lab/statistics-mcp/issues"},"license":"MIT","readme":"# 神岛数据统计 MCP 服务器\n\n[![smithery badge](https://smithery.ai/badge/@box3lab/statistics-mcp)](https://smithery.ai/server/@box3lab/statistics-mcp)\n\n基于 Model Context Protocol (MCP) 的服务器，提供对神岛平台用户数据、地图信息和统计数据的访问。\n\n## 功能特点\n\n- **公开 API**: 无需认证访问的基础数据（用户资料、地图详情、评论列表）\n- **认证 API**: 需要 Token 访问的高级数据（用户评论、各类统计数据）\n- **地图分析**: 全面的地图玩家数据、留存率、行为分析等\n- **类型安全**: 完整的 TypeScript 类型定义，提供代码提示和错误检查\n- **模块化设计**: 清晰的代码结构，易于维护和扩展\n- **标准接口**: 基于 MCP 协议，提供标准化的工具接口\n- **易于集成**: 支持多平台客户端集成，包括浏览器、CLI 等\n\n## 可用工具\n\n### 公开 API (无需认证)\n\n| 工具名称            | 描述                       | 参数                                                     |\n| ------------------- | -------------------------- | -------------------------------------------------------- |\n| `getUserProfile`    | 获取用户个人资料           | `userId`                                                 |\n| `getMapInfo`        | 获取地图详情信息           | `mapId`                                                  |\n| `getMapCommentList` | 获取地图评论列表           | `contentId`, `limit`, `offset`, `orderBy`, `contentType` |\n| `getMapReleaseInfo` | 获取地图发布信息           | `contentId`, `limit`, `offset`                           |\n| `getMapList`        | 通过模糊关键字获取地图列表 | `keyword`, `limit`, `offset` ,`orderBy`                  |\n\n### 需要认证的 API\n\n| 工具名称                | 描述             | 参数                                                  |\n| ----------------------- | ---------------- | ----------------------------------------------------- |\n| `getCommentList`        | 获取用户评论列表 | `offset`, `limit`, `token`, `userAgent`               |\n| `getMapStatList`        | 获取地图统计列表 | `startTime`, `endTime`, `token`, `userAgent`          |\n| `getMapPlayerStatList`  | 获取地图玩家统计 | `startTime`, `endTime`, `mapId`, `token`, `userAgent` |\n| `getMapPlayerRetention` | 获取地图玩家留存 | `startTime`, `endTime`, `mapId`, `token`, `userAgent` |\n| `getMapPlayerBehavior`  | 获取地图玩家行为 | `startTime`, `endTime`, `mapId`, `token`, `userAgent` |\n\n## 客户端示例\n\n### 公开 API 调用示例\n\n```typescript\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\n\n// 创建传输通道\nconst transport = new StdioClientTransport({\n  command: \"npx\",\n  args: [\"-y\", \"@smithery/cli@latest\", \"run\", \"@dao3fun/statistics-mcp\"],\n});\n\n// 初始化客户端\nconst client = new Client(\n  { name: \"dao3-client\", version: \"1.0.0\" },\n  { capabilities: { tools: {} } }\n);\n\n// 连接到服务器\nawait client.connect(transport);\n\n// 获取用户资料 (公开API)\nconst userProfile = await client.callTool({\n  name: \"getUserProfile\",\n  arguments: { userId: \"83354\" },\n});\n\n// 获取地图详情 (公开API)\nconst mapInfo = await client.callTool({\n  name: \"getMapInfo\",\n  arguments: { mapId: \"100131463\" },\n});\n\nconsole.log(JSON.parse(userProfile.content[0].text));\n```\n\n### 需要认证的 API 调用示例\n\n```typescript\n// 认证信息\nconst token = \"YOUR_TOKEN\";\nconst userAgent = \"Mozilla/5.0 ...\";\n\n// 获取地图统计数据 (需要认证)\nconst mapStats = await client.callTool({\n  name: \"getMapStatList\",\n  arguments: {\n    startTime: \"2025-03-29\",\n    endTime: \"2025-04-04\",\n    token,\n    userAgent,\n  },\n});\n\n// 获取地图玩家留存率 (需要认证)\nconst retention = await client.callTool({\n  name: \"getMapPlayerRetention\",\n  arguments: {\n    startTime: \"2025-03-29\",\n    endTime: \"2025-04-04\",\n    mapId: \"100131463\",\n    token,\n    userAgent,\n  },\n});\n\n// 处理响应\nconst statsData = JSON.parse(mapStats.content[0].text);\n```\n\n## 项目结构\n\n```\n├── index.ts                # 主入口文件\n├── src/                    # 源代码目录\n│   ├── types/              # 类型定义\n│   │   └── index.ts        # 共享类型定义\n│   ├── utils/              # 工具函数\n│   │   └── api.ts          # API请求工具\n│   └── tools/              # MCP工具实现\n│       ├── publicTools.ts  # 公开API工具\n│       └── authTools.ts    # 需要认证的API工具\n├── package.json            # 项目配置和依赖\n├── tsconfig.json           # TypeScript配置\n└── README.md               # 项目文档\n```\n\n## 添加新的 API 端点\n\n要添加新的 API 端点，请按照以下步骤操作：\n\n1. 在 `src/types/index.ts` 中添加新的类型定义（如需要）\n2. 对于公开 API，在 `src/tools/publicTools.ts` 中添加新的工具定义\n3. 对于需要认证的 API，在 `src/tools/authTools.ts` 中添加新的工具定义\n\n## 技术栈\n\n- TypeScript\n- Model Context Protocol (MCP)\n- Zod (类型验证)\n- Axios (HTTP 请求)\n\n## 许可证\n\nMIT\n","readmeFilename":"README.md","_rev":"1-43c7f0d19db76fcbb8c99cb7396bb109"}