1. 微信聊天记录接进 ClaudeMCP 插件到底解决了什么问题微信聊天记录里藏着大量真实语料项目群里讨论过的接口字段、客户确认过的报价口径、朋友推荐过的餐厅地址。这些内容平时散落在几千条对话里想找的时候只能靠微信自带的搜索框一条条翻。更麻烦的是当你把截图丢给 Claude 或其它大模型时模型只能看到图片里的文字没法按时间、按联系人、按关键词去检索整个聊天库。MCPModel Context Protocol插件就是来解决这个断层的。它做的事情可以理解成在 Claude 这类客户端和本地微信数据之间架一条标准化的数据通道。客户端负责理解你的自然语言问题MCP 服务端负责把问题翻译成对本地聊天记录的查询再把结构化结果返回给模型。整个过程走的是 JSON-RPC over stdio不需要你把聊天记录上传到任何第三方服务器。适合谁用三类人最明显一是经常需要从微信里翻历史决策的产品/运营二是想把私人语料喂给模型做个人知识库的开发者三是已经在用 Claude Code、Cline 这类支持 MCP 的客户端想扩展本地数据源的人。如果你只是偶尔查一条消息微信自带搜索够用但如果你想让 AI 帮你做「上周三张三在项目群里说的那个接口地址是什么」这种跨时间跨会话的检索MCP 插件才值得折腾。这篇会从微信数据导出讲起到 MCP 服务端启动再到 Claude 客户端接入给出可复制的配置片段。同时会把 TaoToken 统一 Key 的 Base URL 设置讲清楚让你不用在多个模型供应商之间来回切换 Key。最后附一次对话验证确认聊天记录能被正确检索。需要提前说明微信聊天记录属于个人隐私数据导出和接入的过程全部在本地完成不要把这些数据传到不可信的远端服务。MCP 服务端本身只做本地查询TaoToken 在这里承担的是模型 API 的统一入口角色不接触你的聊天数据。2. TaoToken 前置准备统一 Key 与 Base URL 怎么配在接 MCP 之前先把模型侧的入口理顺。很多人卡住不是因为 MCP 配置写错而是客户端里同时存在好几个供应商的 KeyClaude Code 用 Anthropic 的、Cline 用 OpenAI 的、Codex 又用另一个改一个配置要翻三处文档。TaoToken 的思路是给你一个统一的 Base URL 和一个 Key客户端里只填这一组模型 ID 按需切换。先拿 Key。打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制出来。这个 Key 后面会同时用在 Claude Code 的 settings、Cline 的 MCP 配置、以及 Codex 的 auth.json 里。注意 Key 只在创建时完整显示一次丢了就重新建一个。Base URL 统一填https://taotoken.net/api不要带任何路径后缀。有些客户端会在 Base URL 后面自动拼/v1/messages或/v1/chat/completions所以这里只写到/api就行。模型 ID 这块Claude 系列常用claude-sonnet-4-5、claude-opus-4-1这类标识具体以 https://taotoken.net/doc 上的模型列表为准。MCP 场景下建议用 Sonnet 级别工具调用稳定、延迟低Opus 适合复杂推理但成本高一些。如果你用的是 Claude Code配置写在~/.claude/settings.json如果用 Cline配置在 VS Code 的 settings 里如果用 Codex CLI配置在~/.codex/auth.json。三者的共同点是Base URL 都是https://taotoken.net/apiKey 都是刚才创建的那一个Model ID 按客户端支持的格式填。这里有个容易踩的坑Claude Code 默认会去连 Anthropic 官方端点如果你只改了 Key 没改 Base URL请求还是会打到官方然后报 401。所以 Base URL 必须显式覆盖。另一个坑是有些客户端把 Base URL 和完整 endpoint 混在一起比如填了https://taotoken.net/api/v1/messages结果客户端又拼了一次/v1/messages变成双路径。记住只填到/api。TaoToken 在这里的角色是模型 API 的统一网关你的聊天记录数据始终在本地 MCP 服务端和 Claude 客户端之间流转不经过 TaoToken。这一点在配置时心里要有数避免把隐私数据和 API 网关混为一谈。3. 可复制配置微信 MCP 服务端 Claude 客户端接入这一节是全文的核心给出可以直接复制的配置片段。分三步微信数据导出、MCP 服务端启动、Claude 客户端接入。3.1 微信聊天记录导出MCP 服务端需要读取本地的微信数据库。不同版本的微信数据目录不一样Windows 下通常在Documents\WeChat Files\或xwechat_files\macOS 下在~/Library/Containers/com.tencent.xinWeChat/。你需要先把聊天记录导出成 MCP 服务端能读的格式。社区里常用的方案是先用微信自带的「备份与恢复」把记录备份到本地再用导出工具转成 SQLite 或 JSON。这里不展开具体导出工具的安装重点放在导出后的目录结构。假设你导出到了~/wechat-export/里面按联系人分目录每个目录下有messages.json和media/子目录。MCP 服务端启动时需要指定这个导出目录配置里叫saveDir或dataDir具体字段名以你用的 MCP 服务端文档为准。导出完成后先确认目录里有内容别急着启动服务端。3.2 MCP 服务端配置MCP 服务端一般通过npx或本地 Node 脚本启动。下面是一个通用的 MCP 配置片段放在 Claude 客户端的 MCP 配置文件里。Claude Code 的 MCP 配置在~/.claude/mcp.jsonCline 的在 VS Code settings 的cline.mcpServers字段。{ mcpServers: { wechat-log: { command: npx, args: [ -y, wechatlog-mcp-server, --data-dir, /Users/yourname/wechat-export, --save-dir, /Users/yourname/wechat-media ], env: { WECHAT_LOG_DATA_DIR: /Users/yourname/wechat-export, WECHAT_LOG_SAVE_DIR: /Users/yourname/wechat-media } } } }把/Users/yourname/wechat-export换成你实际的导出目录。saveDir是媒体文件落盘的位置语音、图片、视频会被下载到这里模型只拿到 File URI不直接读二进制。如果你用的是 Claude Code还需要在~/.claude/settings.json里配置模型入口确保 MCP 工具调用走的是 TaoToken{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken Key, ANTHROPIC_MODEL: claude-sonnet-4-5 } }注意ANTHROPIC_BASE_URL只写到/api不要加/v1。ANTHROPIC_API_KEY填你在 TaoToken 创建的 Key。ANTHROPIC_MODEL填模型 ID具体以文档为准。如果你用的是 ClineMCP 配置和模型配置是分开的。MCP 部分填上面的mcpServers模型部分在 Cline 的设置里选「Anthropic Compatible」Base URL 填https://taotoken.net/apiAPI Key 填 TaoToken KeyModel ID 填claude-sonnet-4-5。如果你用的是 Codex CLI配置在~/.codex/auth.json{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken Key, model: claude-sonnet-4-5 }三件套记住Base URL 是https://taotoken.net/apiKey 是 TaoToken 创建的 KeyModel ID 是claude-sonnet-4-5这类标识。三个客户端都按这个填不用记多套。3.3 启动与验证配置写完后重启 Claude 客户端。Claude Code 里可以用/mcp命令查看 MCP 服务端是否连上。如果显示wechat-log状态为 connected说明服务端启动成功。Cline 里在 MCP 面板能看到服务端列表和工具数量。第一次启动时MCP 服务端会扫描导出目录建立索引。数据量大时可能要等几十秒。启动日志里会打印扫描到的会话数和消息数确认这两个数字和你导出的量级对得上。4. 验证请求一次对话确认聊天记录可被检索配置完成后最直接的验证方式是问一个只有聊天记录里才有答案的问题。比如「上周三项目群里张三说的接口地址是什么」或者「帮我找一下李四推荐的那家餐厅」。在 Claude Code 里直接输入这个问题模型会判断需要调用 MCP 工具然后发出queryChatLog之类的工具调用。你会在终端看到工具调用的 JSON-RPC 请求和返回结果。返回结果里包含匹配的消息、时间戳、发送者 ID。如果一切正常模型会基于返回的消息给出答案并引用具体的时间和联系人。这时候你可以追问「把那条消息的上下文前后五条也发我」模型会再次调用工具带上时间范围参数。验证成功的标志有三个一是 MCP 服务端日志里出现查询请求二是 Claude 客户端显示工具调用成功三是模型回答里包含聊天记录里的具体内容而不是泛泛而谈。如果模型没有调用工具而是直接回答「我无法访问你的微信记录」说明 MCP 服务端没连上或者模型没识别出需要调用工具。这时候先检查/mcp状态再检查 MCP 配置里的路径是否正确。媒体文件的验证稍微不同。问「把张三上周发的那个语音转成文字」模型会先调用查询工具找到消息 ID再调用downloadVoice之类的工具把语音下载到saveDir然后返回 File URI。你可以在saveDir里看到落盘的音频文件。注意模型本身不转写语音它只拿到文件路径转写需要另外的多模态工具或本地 ASR。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节列几个真实会遇到的报错以及对应的排查方向。401 Unauthorized最常见的原因是 Base URL 没改请求打到了官方端点。检查ANTHROPIC_BASE_URL是否填了https://taotoken.net/api以及 Key 是否复制完整。另一个原因是 Key 被删除或过期去 https://taotoken.net/api-keys 确认 Key 状态。如果 Key 没问题检查客户端有没有在 Base URL 后面自动拼/v1/messages导致路径变成https://taotoken.net/api/v1/messages这个路径是对的但如果填成了https://taotoken.net/api/v1就会双拼。local proxy failed这个报错通常出现在客户端配置了本地代理端口但代理没启动。检查客户端设置里有没有http_proxy或https_proxy环境变量如果有确认代理服务在运行。MCP 场景下不需要额外代理TaoToken 的 Base URL 直接可达。如果之前配过代理把相关环境变量清掉再试。reading choices 报错这个一般出现在 OpenAI 兼容接口的响应解析上。如果你用的客户端走的是/v1/chat/completions但模型返回的是 Anthropic 格式解析就会失败。检查客户端的接口类型设置Anthropic 兼容模式走/v1/messagesOpenAI 兼容模式走/v1/chat/completions。TaoToken 两种都支持但客户端要选对。如果报错信息里有choices字段缺失说明客户端在按 OpenAI 格式解析 Anthropic 响应切换接口类型即可。OAuth 相关报错Claude Code 某些版本会尝试 OAuth 登录如果你用的是 API Key 模式需要在 settings 里显式设置ANTHROPIC_API_KEY并确保没有残留的 OAuth token。检查~/.claude/目录下有没有credentials.json之类的文件如果有先备份再删除让客户端走 API Key 模式。另外确认ANTHROPIC_BASE_URL已设置否则客户端可能仍然尝试官方 OAuth 流程。MCP 服务端启动失败检查npx是否能正常执行Node 版本是否满足要求。如果报command not found说明npx不在 PATH 里。如果报模块找不到检查包名是否正确。启动失败时先在终端手动执行一遍npx -y wechatlog-mcp-server --data-dir ...看具体报错。查询返回空结果检查导出目录里是否真的有数据以及 MCP 服务端扫描到的会话数是否大于零。如果导出目录结构和服务端预期的不一致查询会返回空。这时候看服务端日志里的扫描路径确认它读的是你导出的目录。排查顺序建议先确认模型 API 通用模型对话发一条简单消息再确认 MCP 服务端通/mcp状态最后确认查询逻辑通问一个具体问题。三层分开排查比一上来就改配置高效。6. 长期使用建议与入口汇总跑通之后日常使用有几个小技巧。一是导出目录定期更新微信记录是持续增长的MCP 服务端不会自动同步需要你重新导出后重启服务端。二是媒体文件会占磁盘saveDir建议单独放一个盘定期清理。三是查询时尽量带时间范围或联系人模型生成的查询向量会更精准返回的 token 也少。如果你打算长期用 MCP 做本地知识库建议把 Coding Plan 用起来模型调用走套餐比按量更划算适合高频工具调用的场景。入口在 https://taotoken.net/coding-plan 。需要验证模型是否正常响应时可以用模型对话页面发一条测试消息确认 Base URL 和 Key 生效https://taotoken.net/model-chat 。接入文档和模型列表在 https://taotoken.net/doc 配置过程中遇到字段不确定的以文档为准。API Key 管理在 https://taotoken.net/api-keys Key 泄露或丢失时及时重建。Claude Code 相关的 deep link 在 https://taotoken.net/claude-code 里面有 settings 配置的完整示例。控制台在 https://taotoken.net/console 可以查看调用量和余额。最后提醒一句微信聊天记录是隐私数据MCP 服务端和导出目录都放在本地不要把这些目录同步到网盘或提交到 Git。TaoToken 只负责模型 API 的统一入口不接触你的本地数据。配置时把 Base URL 和 Key 填对剩下的就是让模型帮你从聊天记录里挖出那些被埋没的信息。