# 企鹅物流数据统计 MCP 服务器 让你的 AI 助手直接查明日方舟掉率。企鹅物流数据统计（penguin-stats.io）汇总玩家上报的每一关掉落，覆盖国服、美服（国际服）、日服、韩服。接入这个服务器后，Cherry Studio、Claude、ChatGPT、Cursor、VS Code 等 AI 应用就能替你查询最新的掉率和刷图效率。 MCP（Model Context Protocol）是 AI 应用连接外部工具的标准方式。 **免费 · 无需注册 · 无需 API Key · 只读** ## 让 AI 帮你装 把下面这段话发给 Claude Code、Codex、Cursor 等编程助手： ```text 请为当前这个 AI 工具添加「企鹅物流数据统计」MCP 服务器：地址 https://mcp.penguin-stats.io/mcp ，传输方式 Streamable HTTP，无需认证。按 https://mcp.penguin-stats.io/llms.txt 中对应客户端的步骤，以用户（全局）范围添加，完成后列出它的工具，确认连接成功。 ``` ## 安装 | | | |---|---| | 服务器地址 | `https://mcp.penguin-stats.io/mcp` | | 传输方式 | Streamable HTTP（不是 SSE） | | 认证 | 无。应用询问时，选择「无认证」「No authentication」或「No sign in」 | | 建议名称 | `penguin-stats` | 请完整填写以 `/mcp` 结尾的地址。本页（https://mcp.penguin-stats.io/ ）是说明页，不是服务器地址。 **一键添加：** [添加到 Cherry Studio](cherrystudio://mcp/install?servers=eyJtY3BTZXJ2ZXJzIjp7InBlbmd1aW4tc3RhdHMiOnsidHlwZSI6InN0cmVhbWFibGVIdHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AucGVuZ3Vpbi1zdGF0cy5pby9tY3AifX19) · [添加到 Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Penguin%20Statistics&connectorUrl=https%3A%2F%2Fmcp.penguin-stats.io%2Fmcp) · [添加到 Cursor](https://cursor.com/en/install-mcp?name=penguin-stats&config=eyJ1cmwiOiJodHRwczovL21jcC5wZW5ndWluLXN0YXRzLmlvL21jcCJ9) · [添加到 VS Code](https://vscode.dev/redirect/mcp/install?name=penguin-stats&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.penguin-stats.io%2Fmcp%22%7D) 这些链接只会打开对应应用并预填信息，最后仍需你确认。 ### 聊天应用 #### Cherry Studio 一键添加：[添加到 Cherry Studio](cherrystudio://mcp/install?servers=eyJtY3BTZXJ2ZXJzIjp7InBlbmd1aW4tc3RhdHMiOnsidHlwZSI6InN0cmVhbWFibGVIdHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AucGVuZ3Vpbi1zdGF0cy5pby9tY3AifX19)（需要较新版本）。导入后服务器默认关闭，确认无误后手动开启。点击没有反应时，请用下面的手动方式。 手动添加：【设置】→【MCP】→【MCP 服务器】→【添加】→「从 JSON 导入」，粘贴： ```json {"mcpServers":{"penguin-stats":{"type":"streamableHttp","url":"https://mcp.penguin-stats.io/mcp"}}} ``` `"type": "streamableHttp"` 不能省略。省略时 Cherry Studio 会按旧的 SSE 方式连接，导致失败。 启用：在【工作】→ Agent 菜单 →【编辑】→【MCP】中启用该服务器（以你的版本界面为准）。 文档：https://docs.cherryai.com.cn/advanced-basic/extensions/mcp #### Claude（网页版、桌面版、手机 App） 1. 点击 [添加到 Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Penguin%20Statistics&connectorUrl=https%3A%2F%2Fmcp.penguin-stats.io%2Fmcp)，或进入 **Customize → Connectors → + Add → Add custom connector**（自定义连接器）。 2. 名称填 `Penguin Statistics`，远程 MCP 服务器地址填 `https://mcp.penguin-stats.io/mcp`，点 **Continue**。 3. **Authentication**（认证）选 **No sign in**（无需登录），再点 **Add**。 4. 在对话中点 **+ → Connectors**，打开 Penguin Statistics。 免费版可添加 1 个自定义连接器。Team / Enterprise 需由管理员在 **Organization settings → Connectors** 中添加，成员再点 **Connect**。手机 App 不能直接添加：在网页版或桌面版添加后会自动同步。用同一账号登录的 Claude Code 也能使用。 文档：https://support.claude.com/zh-CN/articles/11175166 #### ChatGPT（网页版） 1. 打开 https://chatgpt.com/plugins ，点 **+**，选择 **Add custom MCP server**（添加自定义 MCP 服务器）。 2. 名称填 `Penguin Statistics`，Server URL 填 `https://mcp.penguin-stats.io/mcp`。 3. Authentication 选 **No authentication**（无认证）。阅读风险提示后点 **I understand and want to continue**，再点 **Create as a plugin**。 4. 安装该插件；在对话框输入 **@** 并选择 Penguin Statistics。 能否使用取决于你的订阅和工作区设置。ChatGPT 桌面版使用 Codex 的配置，见下方 Codex。 文档：https://developers.openai.com/api/docs/guides/custom-mcp-server ### 编程工具 #### Cursor [添加到 Cursor](https://cursor.com/en/install-mcp?name=penguin-stats&config=eyJ1cmwiOiJodHRwczovL21jcC5wZW5ndWluLXN0YXRzLmlvL21jcCJ9)，或在 `~/.cursor/mcp.json` 中加入： ```json {"mcpServers":{"penguin-stats":{"url":"https://mcp.penguin-stats.io/mcp"}}} ``` 文档：https://cursor.com/docs/mcp #### VS Code（GitHub Copilot） [添加到 VS Code](https://vscode.dev/redirect/mcp/install?name=penguin-stats&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.penguin-stats.io%2Fmcp%22%7D) · [VS Code Insiders](https://vscode.dev/redirect/mcp/install?name=penguin-stats&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.penguin-stats.io%2Fmcp%22%7D&quality=insiders) 或在命令面板执行 **MCP: Add Server**，选择 **HTTP (HTTP or Server-Sent Events)**，粘贴地址，服务器 ID 填 `penguin-stats`，然后选择 **Global**，出现提示时再选 **Copilot Global**。服务器会保存到 `~/.copilot/mcp-config.json`（设置了 `COPILOT_HOME` 时为 `$COPILOT_HOME/mcp-config.json`），也可以手动编辑，顶层键是 `mcpServers`： ```json {"mcpServers":{"penguin-stats":{"type":"http","url":"https://mcp.penguin-stats.io/mcp"}}} ``` 或在终端运行下面的命令，它会把服务器加到用户配置（user profile）的 `mcp.json`： ```sh code --add-mcp '{"name":"penguin-stats","type":"http","url":"https://mcp.penguin-stats.io/mcp"}' ``` `.vscode/mcp.json` 和用户配置的 `mcp.json` 为兼容而保留，使用 VS Code 格式：顶层键是 `servers`，不是 `mcpServers`： ```json {"servers":{"penguin-stats":{"type":"http","url":"https://mcp.penguin-stats.io/mcp"}}} ``` 文档：https://code.visualstudio.com/docs/agent-customization/mcp-servers #### Claude Code 推荐安装插件，它会同时装好服务器和技能（见下方「插件与技能」）： ```sh claude plugin marketplace add penguin-statistics/agent-skills claude plugin install penguin-stats@penguin-statistics ``` 或只添加服务器： ```sh claude mcp add --transport http --scope user penguin-stats https://mcp.penguin-stats.io/mcp ``` 用 `claude mcp list` 或 `/mcp` 检查。项目内的 `.mcp.json` 必须写 `"type": "http"`： ```json {"mcpServers":{"penguin-stats":{"type":"http","url":"https://mcp.penguin-stats.io/mcp"}}} ``` 文档：https://code.claude.com/docs/en/mcp #### Codex（CLI、IDE 插件、ChatGPT 桌面版） ```sh codex mcp add penguin-stats --url https://mcp.penguin-stats.io/mcp ``` 或在 `~/.codex/config.toml` 中加入： ```toml [mcp_servers.penguin-stats] url = "https://mcp.penguin-stats.io/mcp" ``` IDE 插件和 ChatGPT 桌面版共用这个文件。在它们的界面中：**Settings → MCP servers → Add server → Streamable HTTP**，粘贴地址，**Save** 后 **Restart**。 文档：https://learn.chatgpt.com/docs/extend/mcp #### Trae 设置 → MCP → 添加 → 手动添加（Create Manually），粘贴下面的内容后确认（菜单名以实际界面为准）： ```json {"mcpServers":{"penguin-stats":{"url":"https://mcp.penguin-stats.io/mcp"}}} ``` 文档：https://docs.trae.cn/ide/model-context-protocol #### Gemini CLI ```sh gemini mcp add --transport http -s user penguin-stats https://mcp.penguin-stats.io/mcp ``` 手动编辑 `~/.gemini/settings.json` 时请用 `httpUrl`（在 Gemini 中 `url` 表示旧的 SSE 方式）： ```json {"mcpServers":{"penguin-stats":{"httpUrl":"https://mcp.penguin-stats.io/mcp"}}} ``` 文档：https://geminicli.com/docs/tools/mcp-server/ #### Cline **MCP Servers → Remote Servers**：名称 `penguin-stats`，填入地址，Transport Type 选 **Streamable HTTP**，点 **Add Server**。在 `cline_mcp_settings.json` 中必须写明类型（默认是 SSE）： ```json {"mcpServers":{"penguin-stats":{"type":"streamableHttp","url":"https://mcp.penguin-stats.io/mcp"}}} ``` 命令行：`cline mcp add penguin-stats https://mcp.penguin-stats.io/mcp --transport http --yes` 文档：https://docs.cline.bot/mcp/mcp-overview ### 其他应用 | 应用 | 位置 | 填写内容 | |---|---|---| | GitHub Copilot CLI | 终端 | `copilot mcp add --transport http penguin-stats https://mcp.penguin-stats.io/mcp` | | Windsurf / Devin Desktop（Cascade 智能体） | `mcp_config.json` | `{"mcpServers":{"penguin-stats":{"serverUrl":"https://mcp.penguin-stats.io/mcp"}}}`（`serverUrl` 或 `url`） | | Devin CLI、Devin Desktop（Devin Local 智能体） | 终端 | `devin mcp add -s user penguin-stats https://mcp.penguin-stats.io/mcp` | | Zed | `settings.json` | `{"context_servers":{"penguin-stats":{"url":"https://mcp.penguin-stats.io/mcp"}}}` | | JetBrains AI Assistant | Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add → HTTP | `{"mcpServers":{"penguin-stats":{"url":"https://mcp.penguin-stats.io/mcp"}}}` | | LM Studio 0.3.17+ | [添加到 LM Studio](https://lmstudio.ai/install-mcp?name=penguin-stats&config=eyJ1cmwiOiJodHRwczovL21jcC5wZW5ndWluLXN0YXRzLmlvL21jcCJ9)，或 Program → Install → Edit mcp.json | `{"mcpServers":{"penguin-stats":{"url":"https://mcp.penguin-stats.io/mcp"}}}` | | opencode | `opencode.json` | `{"mcp":{"penguin-stats":{"type":"remote","url":"https://mcp.penguin-stats.io/mcp","enabled":true}}}` | | Kiro | `~/.kiro/settings/mcp.json` | `{"mcpServers":{"penguin-stats":{"url":"https://mcp.penguin-stats.io/mcp"}}}` | | Goose | [添加到 Goose](goose://extension?url=https%3A%2F%2Fmcp.penguin-stats.io%2Fmcp&type=streamable_http&id=penguin-stats&name=Penguin%20Statistics&description=Arknights%20drop%20rates)，或 `goose configure` → Remote Extension (Streamable HTTP) | 服务器地址 | | Warp | Settings → Agents → MCP servers → + Add | `{"penguin-stats":{"url":"https://mcp.penguin-stats.io/mcp"}}` | | Raycast（Pro） | 「Install MCP Server」命令 → Transport 选 HTTP | 服务器地址 | | 一次装到多个应用（需 Node.js） | 终端 | `npx -y add-mcp https://mcp.penguin-stats.io/mcp --name penguin-stats -g` | | 其他应用 | | 远程 MCP 服务器，Streamable HTTP，填入地址，无需认证 | | 只支持本地（stdio）服务器的应用 | 配置文件 | `{"mcpServers":{"penguin-stats":{"command":"npx","args":["-y","mcp-remote","https://mcp.penguin-stats.io/mcp","--transport","http-only"]}}}`（需要 Node.js） | ## 试一试 中文、英文、日文、韩文都可以问；物品的别名、外号、拼音也能识别。 - 国服固源岩去哪刷最划算？按每个固源岩的理智消耗列出前三个关卡。 - 国服 1-7 现在掉什么？各自掉率多少？ - 国服现在有哪些活动开放？活动关卡分别掉什么？ - 对比国服和美服刷装置的最佳关卡。 - 日服的数据最近一次更新是什么时候？ - 写一个 Python 脚本，用企鹅物流的数据列出国服固源岩掉率最高的 3 个关卡，并打印数据时间和出处。 **确认已接通：** 问「用企鹅物流查一下国服固源岩去哪刷最划算」。正常的回答会说明服务器和数据时间，并注明「数据来源：企鹅物流数据统计」。如果助手没调用工具就直接回答，请明确说「用 Penguin Statistics 的工具查」。 ## 插件与技能（可选） MCP 服务器给助手提供数据；`penguin-stats-api` 技能教它正确使用这些数据：说明服务器、优先参考样本大的关卡、注明数据时间和出处，并能写出正确调用 REST API 的代码。插件会把两者一起装好。 - Claude Code：`/plugin marketplace add penguin-statistics/agent-skills`，再 `/plugin install penguin-stats@penguin-statistics` - Claude（网页版、桌面版）：**Customize → Plugins → Add → Add marketplace** → 填 `penguin-statistics/agent-skills`，选中 **Penguin Statistics** 后点 **Add**，然后在插件的 **Connectors** 标签页添加并连接服务器（无需登录；Team 和 Enterprise 方案由 Owner 添加连接器） - Codex：`codex plugin marketplace add penguin-statistics/agent-skills`，再 `codex plugin add penguin-stats@penguin-statistics` - Gemini CLI：`gemini extensions install https://github.com/penguin-statistics/agent-skills` - VS Code：开启 `chat.plugins.enabled` 后执行 **Chat: Install Plugin From Source** → `https://github.com/penguin-statistics/agent-skills` - 只装技能（任意 AI 编程工具）：`npx skills add penguin-statistics/agent-skills` 如果之前手动添加过本服务器：Claude 和 Claude Code 会把它和插件里的服务器当作同一个，保留即可；在其他应用里，请删除手动添加的那一项，否则工具可能重复加载。源代码：https://github.com/penguin-statistics/agent-skills ## 工具 全部只读：不会修改任何数据，也不能替你上报掉落。 | 工具 | 作用 | |---|---| | `search_items` | 按中/英/日/韩名称、外号（如「狗粮」「石头」）、拼音或 ID 查找物品 | | `search_stages` | 按关卡代号（1-7、S2-12）、关卡 ID、章节或活动名查找关卡 | | `get_item_drop_rates` | 某物品在某服务器去哪刷：各关卡次数、掉率、单件理智 | | `get_stage_drops` | 某关卡掉什么，以及各物品的掉率 | | `list_events` | 某服务器正在开放或即将开放的活动及其关卡 | | `get_dataset_info` | 数字的含义、各服务器数据的更新时间、注意事项、许可与署名方式 | ## 数据与许可 - 数据来自玩家上报，按服务器分别统计：国服（CN）、美服（US，即国际服/英文服）、日服（JP）、韩服（KR）。每个回答都附带数据计算时间。 - 掉率 = 掉落数量 ÷ 次数，可以超过 100%；次数少于 100 的掉率波动较大。 - 许可：[CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/deed.zh-hans)，可用于非商业用途，需署名：`数据来源：企鹅物流数据统计（penguin-stats.io），CC BY-NC 4.0`（英文：`Data: Penguin Statistics (penguin-stats.io), CC BY-NC 4.0`）。服务器会提示 AI 在回答中注明出处。 ## 用量限制 - 每个 IP 每分钟 120 次请求（IPv6 按 /64 计）。一次提问通常只需 2–4 次请求。 - 超出后服务器会返回「rate limited, retry after N s」，等待相应秒数后重试即可。 - Claude 网页版、ChatGPT 等云端助手从各自公司的服务器发起连接，可能与其他用户共用额度；遇到该提示请等一分钟。 ## 隐私 - 无需账号、无需 Key、不使用 Cookie。本页不加载任何第三方脚本，没有统计代码。 - 服务器只能收到 AI 助手发来的内容：工具名和参数（例如物品名），看不到你的对话内容。 - 每次请求我们会记录：时间、IP 地址（及其所属的国家、城市和网络）、User-Agent、MCP 客户端名称和版本、调用的方法和工具名、结果和耗时。不记录工具参数，但调用失败时，记录的错误信息可能引用出错的参数（例如不存在的物品名）。 - 日志由我们的监控服务商（Datadog）保存 15 天后删除，仅用于运维、防止滥用和统计各工具与客户端的使用情况，不会出售，也不会用于广告。 - 请求经过 Cloudflare，由 Cloudflare 按其自身条款处理。 ## 常见问题 - **连不上、提示 SSE 错误或 405：** 应用可能在用旧的 SSE 方式，本服务器不支持。请改为 Streamable HTTP：Cherry Studio 和 Cline 写 `"type": "streamableHttp"`，Gemini CLI 用 `httpUrl`。在这几个应用里只写 `url` 就表示 SSE。 - **VS Code 里看不到服务器：** `~/.copilot/mcp-config.json` 和工作区的 `.mcp.json` 顶层键是 `mcpServers`；`.vscode/mcp.json` 和用户配置的 `mcp.json` 顶层键是 `servers`。 - **要求登录或授权：** 本服务器无需认证，选「No sign in」或「No authentication」。 - **在浏览器打开 `/mcp` 跳到了本页：** 正常。这个地址只接受 AI 应用的 POST 请求。 - **提示 rate limited：** 见「用量限制」。 - **添加了但 AI 不调用：** 先在对话中启用（Claude：+ → Connectors；ChatGPT：输入 @ 选择；Cherry Studio：在 Agent 中启用 MCP），再在提问里写明「用企鹅物流查」。 - **和网站上的数字不一样：** 先确认是同一个服务器（默认国服）和时间范围；可以让 AI 说明它用的服务器和数据时间。 - **中国大陆网络：** 本服务器暂无 .cn 镜像，本地运行的应用在大陆可能连接较慢或失败；Claude、ChatGPT 等云端助手从海外服务器连接，不受影响。 **不借助 AI 测试：** 运行 `npx @modelcontextprotocol/inspector`，选择 Streamable HTTP，填入地址，Connect 后点 List Tools。或者： ```sh curl -s https://mcp.penguin-stats.io/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -H 'Mcp-Protocol-Version: 2025-06-18' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` ## 链接 - 网站：https://penguin-stats.io - REST API 文档：https://developer.penguin-stats.io/public-api · OpenAPI：https://penguin-stats.io/swagger/doc.json - 本页 Markdown 版：https://mcp.penguin-stats.io/index.md?lang=zh · 给 AI 读的说明：https://mcp.penguin-stats.io/llms.txt · 全站说明：https://penguin-stats.io/llms.txt - Server card：https://mcp.penguin-stats.io/mcp/server-card - 源代码：https://github.com/penguin-statistics/backend-next （internal/controller/mcp） - 反馈问题：https://github.com/penguin-statistics/backend-next/issues --- 各应用的操作步骤最后核对于 2026-10-23。应用界面经常变化，如发现步骤过时，请[提交 issue](https://github.com/penguin-statistics/backend-next/issues)。 · [English](https://mcp.penguin-stats.io/index.md?lang=en) · [中文](https://mcp.penguin-stats.io/index.md?lang=zh)