Penguin Statistics

io.penguin-stats由 penguin-stats.io 發布官方發布者v1.0.0更新於 Oct 30, 2026

Crowdsourced Arknights drop rates by stage and item, for the CN, US, JP and KR game servers

已驗證Streamable HTTP可網頁執行位置與生活資料與分析

概覽

AI 產生的概覽

唯讀的 MCP 伺服器,提供《明日方舟》依關卡與物品統計的群眾外包掉率,涵蓋 CN、US、JP、KR 伺服器。

可以做什麼
  • 依中、英、日、韓文名稱、別名、拼音或物品 ID 搜尋物品
  • 依關卡代碼、關卡 ID 或區域名稱與 ID 搜尋關卡
  • 依每件所需理智與掉率排序所有會掉落某物品的關卡
  • 查看單一關卡的掉落物、掉率、理智消耗以及目前是否開放
  • 列出活動及其開放、即將開放或已結束狀態與關卡 ID
  • 說明資料涵義、各伺服器資料的新鮮度、注意事項、授權與署名方式
適用情境
適合規劃《明日方舟》刷取:判斷某材料最有效率的關卡、查看某關卡掉落,或了解目前開放的活動。也方便正確引用這些資料。
執行需求
遠端 Streamable HTTP 端點,無需驗證,也不必在本機安裝;需要能連線至該伺服器的網路。
安裝前請注意
資料為群眾外包統計,可能不完整或過時,使用前請查看資料集說明中的新鮮度與注意事項。資料以 CC BY-NC 4.0 授權釋出,僅限非商業用途並需署名。伺服器為唯讀,不涉及帳號或金鑰。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Penguin Statistics,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.penguin-stats%2Fpenguin-stats/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "penguin-statistics": {
      "type": "http",
      "url": "https://mcp.penguin-stats.io/mcp"
    }
  }
}

README

[Penguin Statistics - Logo]

Penguin Statistics - V3 Backend

[License] [Last Commit] [GitHub Actions Status] [go.mod Version] [FOSSA Status]

[Alt]

The re-designed Penguin Statistics v3 Backend, built with Go.

Using the data

The drop data is public:

  • REST API at https://penguin-stats.io/PenguinStats/api/v2/: see the developer docs and the OpenAPI (Swagger 2.0) spec.

  • MCP server for AI assistants (Claude, ChatGPT, Cursor, VS Code, Cherry Studio and others) at https://mcp.penguin-stats.io/mcp: Streamable HTTP, no authentication, read-only. In Claude Code:

    sh
    claude mcp add --transport http --scope user penguin-stats https://mcp.penguin-stats.io/mcp

    The steps for every other app, in English and Chinese, are at https://mcp.penguin-stats.io/.

  • Plugin and skill for coding agents, the MCP server with a skill on reading, citing and querying the numbers: https://github.com/penguin-statistics/agent-skills

The drop data is licensed CC BY-NC 4.0: non-commercial use, with credit. Credit it as Data: Penguin Statistics (penguin-stats.io), CC BY-NC 4.0. The code of this repository is MIT.

Architecture

This Go project mainly uses:

This project mainly follows a RESTful API design.

Operations

Report tasks in the dead-letter stream

The report worker moves a report task out of the penguin-reports stream into penguin-reports-dead (subjects REPORT_DEAD.*) when it can never be processed (it is not a task, or a stage of it does not exist) or when it failed at each of its 30 deliveries, which take about 97 minutes of retry delays. Each move is logged at error level (reportwkr.malformed, reportwkr.parked or reportwkr.dead). The copy keeps the payload as published, with these headers:

  • Penguin-Original-Subject: the subject it was published under, like REPORT.SINGLE
  • Penguin-Original-Sequence: its sequence in penguin-reports
  • Penguin-Deliveries: its deliveries when it moved
  • Penguin-Last-Error: the error that moved it

A task too close to the maximum payload to fit with these headers moves without them, and its subject under REPORT_DEAD.* names its original subject; its move is logged as reportwkr.dead.bare, with the sequence and the error.

Nothing in the stream expires. With the nats CLI, once the cause is fixed:

sh
# list the tasks, with their headersnats stream view penguin-reports-dead# show one, by its sequence in penguin-reports-deadnats stream get penguin-reports-dead 42# replay it under its original subject: the worker processes it as a new tasknats stream get penguin-reports-dead 42 --json | jq -r .data | base64 -d \  | nats pub REPORT.SINGLE --force-stdin# remove it once replayednats stream rmm penguin-reports-dead 42 -f

A task that moved after failing at each delivery may have been stored by one of them whose commit outcome was unknown (for example the connection dropped during the commit); check drop_reports for its account and time before replaying it.

Benchmarks

Report consumer CPU

internal/workers/reportwkr/consumerbench_test.go (build tag consumerbench) drives the report consumer through its real code path: each task is published to a JetStream stream of its own, fetched and handed to Worker.ingestPreprocess (BenchmarkConsumer/ingest), which stores it in PostgreSQL and sets its recall key in Redis, with logging and tracing configured as in production. BenchmarkConsumer/process runs Worker.process alone. Besides wall time and allocations it reports, per task, the CPU time of the process (cpu-ns/op, user + system from getrusage, which a shared machine disturbs far less than the wall time) and the time spent waiting on PostgreSQL (pg-wait-ns/op, pg-wait-%) and Redis.

The tasks (internal/workers/reportwkr/testdata/consumerbench/tasks.jsonl.gz) are encoded as the report handler publishes them, drawn from the stages, servers, times, sources, versions and drop patterns of recent production reports, with synthetic accounts, IPs and task ids.

It needs a scratch database, Redis and NATS with JetStream. The scratch database holds the schema and the reference tables of a restore of production (penguinprod, only read) and synthetic accounts; the benchmark truncates its drop_reports and drop_report_extras:

sh
scripts/consumerbench/setup-db.sh   # creates penguin_cpubench and the role cpubench on 127.0.0.1:5434# regenerate the tasks, if needed: CONSUMERBENCH_TASKS, CONSUMERBENCH_BATCH_PERMILLE, CONSUMERBENCH_SEEDCONSUMERBENCH_GENERATE=1 go test -tags consumerbench -run TestConsumerBenchGenerate ./internal/workers/reportwkr/

The defaults point at penguin_cpubench on 127.0.0.1:5434, Redis DB 14 on 127.0.0.1:16379 and NATS on 127.0.0.1:4222 (CONSUMERBENCH_POSTGRES_DSN, CONSUMERBENCH_REDIS_URL, CONSUMERBENCH_NATS_URL). Then:

sh
# one rungo test -tags consumerbench -run '^$' -bench BenchmarkConsumer -benchtime 2000x ./internal/workers/reportwkr/# interleaved runs of variants, compared with benchstat: logging to a counting io.Discard (prod), to /dev/null# (devnull), disabled (logoff); tracing as in production at 10% (prod), off (traceoff), at 100% (trace1); both off (off)COUNT=10 scripts/consumerbench/run.sh bench prod logoff traceoff off devnull trace1# CPU and allocation profiles of the ingestion, the top functions and the share of each part of the consumerscripts/consumerbench/run.sh profile prod

Outputs go to $OUT (default a new temporary directory). Each run logs the load average and the queries other sessions had active on the cluster to $OUT/runs.log. The PostgreSQL connection runs over loopback, where a write system call also does the receiving side's TCP work, so the system calls weigh more than against a remote server.

Maintainers

This project has mainly being maintained by the following contributors (in alphabetical order):

The full list of active contributors of the Penguin Statistics project can be found at the Team Members page of the website.

Contributors

This project is made possible by the following contributors. Contributions are always welcome!

[Contributors]

License

[FOSSA Status]

來源:README.md,提交 1898c26

工具

6

get_dataset_info

Dataset info

Describes the Penguin Statistics drop data: what its numbers mean (times, quantity, drop rate, sanity per item, window), the game servers with their time zones and how fresh the data of each is, the caveats, the license and how to credit it. Call it when unsure how to read or cite the numbers.

無需輸入參數。

get_item_drop_rates

Item drop rates

Where to farm an item: ranks every stage of a game server that drops it, with sanity per item, drop rate (items per run), runs (times) and quantity. Use it for any question about where to get an item, its best or most efficient stage, or which of several stages to run for it: one call ranks every stage, so don't look stages up one by one with get_stage_drops (only a named stage left out of the top_n returned). By default the stages open now that still drop it, lowest sanity per item first; stages of fewer than 100 runs (lowSample) rank after the others, gachas and the recruitment (no sanity cost) last. sort_by=drop_rate ranks by rate instead; include_closed=true adds past events and ended drops. item_id takes the item's name in any language; search_items first only when the name may mean several items.

輸入參數langtop_nserver必填item_id必填sort_byinclude_closed

get_stage_drops

Stage drops

What one stage drops on a game server: each item with drop rate (items per run), sanity per item, runs (times) and quantity, highest rate first, then the items it no longer drops; with the sanity cost of the stage and whether it is open now. For questions about a given stage. To find where to farm an item, call get_item_drop_rates instead: one call ranks every stage that drops it. Takes the stage ID from search_stages (codes are shared by several stages); a code works too if only one stage on the server has it.

輸入參數langserver必填stage_id必填

list_events

List events

Lists the events (limited-time activities) of a game server: status now (open, upcoming or closed), open and close times, whether a rerun. By default the open and upcoming events with their stage IDs (for get_stage_drops), or the latest 3 if there are none; open_only=false lists every event, latest first, with stage counts only. The main story and the permanent side stories are not events.

輸入參數langlimitserver必填open_only

search_items

Search items

Finds items (materials, battle records, chips, furniture, event items) by name in any language (zh, en, ja, ko), by alias or nickname (土块, 狗粮), by pinyin (guyuanyan) or by item ID, and returns their item IDs (get_item_drop_rates takes a name too; search first when unsure which item is meant) and names in every language. Best matches first: exact before prefix before substring, names before aliases. Several items can share an alias (石头 is each tier of Orirock): ambiguous is then true; ask the user which one is meant or decide by context. Items of other types (workshop-crafted materials such as D32 Steel, recruitment tags) are returned only when no listed item matches, with a note saying what they are.

輸入參數langlimitquery必填

search_stages

Search stages

Finds stages by code (1-7, S2-12, YW-4; full-width characters work too), by stage ID (main_01-07), or by the name or ID of their zone (第十章, Under Tides), and returns their stage IDs (for get_stage_drops; to find the stages that drop an item, use get_item_drop_rates) with their zone, sanity cost and whether they are open on the server now. Codes are not unique: the standard and tough versions of a stage of the main story share them, as do an event, its rerun and the stages it left open for good. Best matches first (the code before the zone, exact before prefix before substring), then the stages open now, standard before tough, original before permanent before rerun. ambiguous is true when several stages share the best-matching code (not for the stages of a zone found by its name): ask the user which one is meant or decide by context.

輸入參數langlimitquery必填server

版本歷史

1
  1. v1.0.0最新Oct 23, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分