# rotki MCP：核隐私模式、加载范围和查询完整性

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/rotki-mcp-query-privacy-completeness-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

按v1.44.1官方源码检查已有AI查询回执，区分缓存余额、历史事件、价格缺失和结果截断。

## 使用工具
- [rotki](https://lianxiaozhi.com/tools/rotki) · [官方入口](https://rotki.com/)

## 前置条件
- 准备已有脱敏的rotki版本、MCP工具输入/输出和隐私模式记录；未配置的用户可仅据本文形成待核清单。
- 依据官方文档及v1.44.1源码，未安装、购买套餐、启动MCP、登录、调用本地或外部API，也未向AI传输账户数据。

## 1. 先固定版本、权限与backend状态

本文的工具字段依据v1.44.1固定源码；先记录已有实例版本及查询回执。MCP除info外要求Basic或更高，Free/Supporter的premium_required不等于零资产。

info提供mcp.version，以及backend.connected、unlocked、version和message。后端能连接但数据库未解锁仍不能用来确认账户数据；桌面通常用127.0.0.1:4445/mcp，Docker认证方式不同。本文不启动、安装、接入或解锁实例。

核对结果：版本、Premium门槛和backend连接/解锁状态各自有证据或未知。
依据：[rotki：MCP访问、Basic门槛与认证差异](https://docs.rotki.com/usage-guides/mcp.md)
依据：[rotki v1.44.1：info版本和backend连接字段](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/tools/info.py)

## 2. 核隐私模式和旧数据处理

balanced默认遮蔽地址、交易哈希和用户账户名，但保留生成的描述及交易场所；strict还遮蔽自由文本，仍保留金额、资产、日期、对手方和位置。raw不遮蔽。本地运行不表示AI服务商收不到查询结果。

官方说明更改模式后需要重新加载分析数据；源码在同步到新模式时清空旧分析缓存，未重载可能返回no_tables_loaded或privacy_mode_changed。仅核已有privacy_mode和回执，不修改设置或把“已遮蔽”写成“没有任何数据外传”。

核对结果：记录实际privacy_mode及重载结果，AI收到的数据范围可说明。
依据：[rotki：隐私模式与数据交给AI服务商的边界](https://rotki.com/features/ai-assistant-mcp)
依据：[rotki v1.44.1：完整性、估值、缓存及结果截断实现](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/analytics.py)

## 3. 核加载表和时间输入

refresh_analytics_data默认tables为history_events；balances需要显式选择。from_timestamp/to_timestamp为0表示无边界，可接受Unix秒或毫秒，历史表timestamp本身为毫秒。核已有具体值与所求日期一致，不靠页面显示日期猜输入单位。

include_ignored_assets默认false，include_values默认false；需历史估值时应核原请求是否true。balances加载的是最新缓存快照且range_scoped=false，不按历史日期过滤，也不强制刷新链上余额。

核对结果：历史事件范围、忽略资产、估值开关和余额快照口径分别记录。
依据：[rotki v1.44.1：加载、schema及SQL工具输入和口径](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/tools/analytics.py)
依据：[rotki v1.44.1：完整性、估值、缓存及结果截断实现](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/analytics.py)

## 4. 先核加载完整性和价格缺口

history_events的source.completeness可为complete、truncated_by_max_events或stopped_early；source.rows_loaded表示本次真正可查询行数。backend_metadata.entries_found是后端序列化前估计，不用两者差值计算“覆盖率”。

include_values=true时才加入price、value和price_missing；历史价格只读本地缓存，缺价格得到NULL而非0。核source.value_currency、priced_rows与unpriced_rows，不能默认金额都是USD，也不能把忽略NULL的汇总写成完整总值。complete只说明所加载范围，不能保证原链索引无遗漏。

核对结果：完整性、实际加载行数、估值币种及缺价格行数均有记录。
依据：[rotki v1.44.1：加载、schema及SQL工具输入和口径](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/tools/analytics.py)
依据：[rotki v1.44.1：完整性、估值、缓存及结果截断实现](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/analytics.py)

## 5. 按schema和taxonomy检查汇总口径

list_tables与describe_table用于确认已加载表、实际列、sqlite_type及null_fraction/all_null；未经核实不套字段。get_event_taxonomy说明direction和event_group，informational行是注释，不能与真实资金事件重复累计。

amount为十进制字符串，amount_float仅能同资产汇总；income不能只按staking事件类型筛，否则可能把退出本金当收益。aggregate_by_group_ids=true每组只取代表事件，并未合并买卖两侧；要核交换两侧须按组关联，不能直接汇总代表行数量。

核对结果：字段类型、事件方向、资产单位和分组方式明确，无本金/注释重复计入。
依据：[rotki v1.44.1：加载、schema及SQL工具输入和口径](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/tools/analytics.py)
依据：[rotki v1.44.1：事件taxonomy与汇总前提](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/tools/taxonomy.py)

## 6. 分开查询结果截断和数据加载截断

query_sql只接受单条只读SELECT/WITH，在已加载的SQLite分析副本上查询。源码默认返回上限500行，max_rows实际限制为1至5000；对照row_count、returned_rows和result_truncated。

结果截断与source.completeness不完整是两层问题。截断的列表不能靠AI把缺失行补出来；即使汇总结果只有一行，也仍需确认底层加载范围和价格完整。没有原回执或出现错误时，结论保持未验证。

核对结果：查询行数、返回行数、结果截断与源加载完整性分列。
依据：[rotki v1.44.1：加载、schema及SQL工具输入和口径](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/tools/analytics.py)
依据：[rotki v1.44.1：完整性、估值、缓存及结果截断实现](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/analytics.py)

## 常见错误
- info成功不表示其他工具已授权或后端数据已解锁。
- 源码字段限固定版本；未来版本及当前实例需另核，未执行工具或性能测试。

## 完成检查
- 留下范围、原始字段、结果与待核项的对应记录；没有实际文件或回执时保持未验证。

## 相关知识

## 官方依据
- [rotki：MCP访问、Basic门槛与认证差异](https://docs.rotki.com/usage-guides/mcp.md)
- [rotki v1.44.1：info版本和backend连接字段](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/tools/info.py)
- [rotki：隐私模式与数据交给AI服务商的边界](https://rotki.com/features/ai-assistant-mcp)
- [rotki v1.44.1：完整性、估值、缓存及结果截断实现](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/analytics.py)
- [rotki v1.44.1：加载、schema及SQL工具输入和口径](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/tools/analytics.py)
- [rotki v1.44.1：事件taxonomy与汇总前提](https://raw.githubusercontent.com/rotki/rotki/v1.44.1/rotkehlchen/mcp/tools/taxonomy.py)