
1. 为什么你的 IP 定位总在“漂移”做用户画像、风控或者本地生活推荐的朋友大概率都遇到过这种尴尬后台拿到一个 IP兴冲冲地查经纬度结果定位直接飘到几公里外的城市中心甚至跨了区。你以为是 IP 库不行换了一家又一家问题依旧。我试过把同一个 IP 丢给好几个查询接口结果五花八门。后来才想明白问题不在“库大不大”而在“网络类型”。一个手机 4G/5G 出口 IP背后是成千上万人共享的基站出口它天然只能定位到城市级一个云服务器机房 IP压根就不代表真实用户位置而企业专线出口才最有可能做到街道级精度。纯真 IP 库这次把网络类型拆成了移动数据、数据中心、物联网、普通宽带、专线出口五类用万亿级数据去区分再配合 S2/H3/GeoHash 编码返回经纬度精度逻辑就清晰多了。更关键的是它支持 MCP 协议。这意味着我可以直接在 Claude Code 里挂一个纯真 IP 的 MCP 工具让模型在会话中帮我调数据、做编码转换而不是自己写一堆胶水代码。但这里有个前置条件Claude Code 本身需要一个能用的模型通道。原来得单独去模型服务商申请 Key现在换成打开 TaoToken 创建 Key把 Base URL 填进 Claude Code 配置模型通道和 MCP 调度就都齐了。下面我把整套流程拆开你可以直接跟着做。2. 前置准备TaoToken 提供模型通道Claude Code 负责调度先把角色分清楚。TaoToken 在这条链路里只做一件事给 Claude Code 提供一个稳定可用的模型通道。它不碰定位数据定位结果全部由纯真 IP 的 API 返回。Claude Code 则是那个“调度员”它通过 MCP 协议去调用纯真 IP 工具把 S2/H3/GeoHash 编码转成你能看懂的经纬度。你需要准备三样东西第一一个 TaoToken 的 API Key。打开https://taotoken.net/注册后进控制台创建 Key。注意 Base URL 要填https://taotoken.net/api不要带多余的路径。第二Claude Code 环境。确保你已经装好 Claude Code CLI能正常启动会话。第三纯真 IP 街道级 API 的访问凭证。去纯真官网的街道级 API 页面申请拿到你的 API Key 和 MCP 接入地址。这一步是纯真侧的事和 TaoToken 无关。注意TaoToken 的 Key 只用于模型对话通道不要把它和纯真 IP 的 Key 混在一起填。两个 Key 各管各的。如果你还没创建 TaoToken 的 Key直接进控制台https://taotoken.net/console在 API Keys 页面点新建。创建完复制出来后面配置要用。想先看看模型对话效果也可以去https://taotoken.net/models试一下通道通不通。3. 可复制配置把 TaoToken 接进 Claude CodeClaude Code 的配置方式取决于你用的版本但核心就两个环境变量ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY。TaoToken 兼容 Anthropic 的接口格式所以直接把 Base URL 指向 TaoToken 的 API 地址即可。在终端里执行export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的TaoToken Key如果你想让配置持久化写进 shell 配置文件echo export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.bashrc echo export ANTHROPIC_API_KEY你的TaoToken Key ~/.bashrc source ~/.bashrcWindows 用户用 PowerShell$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的TaoToken Key配完之后启动 Claude Codeclaude如果能看到正常进入会话说明模型通道已经通了。这一步是整个链路的地基地基不稳后面 MCP 调用会一直报连接错误。接下来配纯真 IP 的 MCP。Claude Code 支持在配置文件里声明 MCP Server。找到你的 Claude Code 配置目录通常在~/.claude/下编辑claude_desktop_config.json或者对应的 MCP 配置文件。加入纯真 IP 的 MCP 服务声明{ mcpServers: { cz88-street: { command: npx, args: [ -y, cz88/mcp-server-street ], env: { CZ88_API_KEY: 你的纯真IP Key } } } }提示纯真 IP 的 MCP Server 包名和启动参数以官方开发文档为准。上面是通用结构你照着文档把 command 和 args 替换成实际值即可。env 里的 Key 填纯真侧申请的 Key不是 TaoToken 的 Key。保存后重启 Claude Code让它加载新的 MCP 配置。4. 验证请求在会话里跑通街道级查询配置加载成功后进入 Claude Code 会话直接问它帮我查一下 IP 1.2.3.4 的街道级定位返回 S2、H3 和 GeoHash 编码。Claude Code 会识别到cz88-street这个 MCP 工具然后调用它。正常返回类似{ ip: 1.2.3.4, network_type: 专线出口, s2: 3e5b8c1a..., h3: 8a2a1072b59ffff, geohash: wtw3sjq6, confidence: high }拿到编码后你可以让 Claude Code 继续帮你转换把上面的 H3 编码转成经纬度。Claude Code 会调用转换逻辑输出类似纬度: 31.2304 经度: 121.4737这就是街道级定位的完整闭环TaoToken 提供模型通道Claude Code 调度 MCP纯真 API 返回编码模型帮你做转换和解释。整个过程你不需要自己写 HTTP 请求也不需要手动查编码表。如果你在会话里看到工具调用被拒绝或者返回MCP server not found先检查 MCP 配置文件的路径对不对再确认 Claude Code 重启后有没有加载成功。可以用/mcp命令查看当前挂载的 MCP 服务列表。5. 本篇常见错排查报错一401 Unauthorized或invalid api key这是 TaoToken 的 Key 没配对。检查ANTHROPIC_API_KEY是不是复制完整了有没有多余空格。另外确认 Base URL 是https://taotoken.net/api不要写成带/v1的路径。TaoToken 的接口路径已经内置好了你多写反而会 404。报错二MCP server cz88-street failed to start纯真 IP 的 MCP Server 没起来。常见原因是npx拉包失败或者CZ88_API_KEY没填。先在终端手动跑一遍npx -y cz88/mcp-server-street看报什么错。如果是网络问题检查你的 npm 源如果是 Key 问题去纯真控制台确认 Key 状态。报错三模型回复“我没有这个工具”Claude Code 没识别到 MCP 工具。确认配置文件放在 Claude Code 能读到的位置并且重启了会话。有些版本需要你在会话里显式说“使用 cz88-street 工具查询”模型才会去调。如果还是不行检查 MCP 配置的 JSON 格式有没有语法错误逗号、引号最容易出问题。报错四返回的经纬度偏差很大先看返回里的network_type。如果是“数据中心”或“移动数据”街道级精度本身就有限这是网络类型决定的不是接口问题。只有“专线出口”和“普通宽带”才有较高的街道级参考价值。纯真 IP 的文档里写得很清楚你可以根据网络类型来判断结果的可信度。报错五S2/H3/GeoHash 转换结果对不上编码转换要用对版本。H3 有 v3 和 v4 的区别S2 也有不同层级。让 Claude Code 转换时明确指定“用 H3 v4 转”或者“用 S2 Level 15 转”。如果你自己写转换脚本注意依赖库的版本要和编码生成时一致。6. 后续怎么用把定位能力接进你的工作流跑通之后你可以把这条链路固化下来。比如在 Claude Code 里写一个自定义 Skill把“查 IP → 拿编码 → 转经纬度 → 判断网络类型”串成一个命令。下次只需要输入 IP就能直接拿到结构化的定位结果。对于长期做编码和 Agent 的朋友可以考虑 TaoToken 的 Coding Plan把模型通道的用量和 MCP 调度放在一起管理。入口在https://taotoken.net/coding-plan。如果你只是想先验证模型对话和 MCP 调用能不能配合用模型对话页面https://taotoken.net/models快速试一次就行。接入文档在https://taotoken.net/docAPI Keys 管理在https://taotoken.net/api-keys。Claude Code 相关的配置细节官方文档里也有对应说明。整套流程的核心就一句话TaoToken 管模型通道Claude Code 管 MCP 调度纯真 IP 管定位数据。三者各司其职你只需要把 Key 和 Base URL 填对剩下的交给会话里的模型去调。