Claude Code 配置微信搜索 MCP 指南

概述

通过配置 weixin_search_mcp 这个 MCP Server，可以让 Claude Code 直接搜索微信公众号文章并读取全文内容。该工具基于搜狗微信搜索接口，提供两个核心能力：

本仓库 fork 自 fancyboi999/weixin_search_mcp，已修复 FastMCP 3.x 兼容性问题和 SOCKS 代理缺少依赖的问题，可直接使用。

• 关键词搜索：搜索微信公众号文章
• 全文提取：获取微信公众号文章的正文内容

前置条件

安装 uv

uv 是现代 Python 包管理工具，它提供的 uvx 命令可以免虚拟环境直接运行 Python 工具。

curl -LsSf https://astral.sh/uv/install.sh | sh

安装完成后，uv 和 uvx 会被安装到 ~/.local/bin/。

确保 ~/.local/bin 在 PATH 中，可在 ~/.zshrc 中添加：

export PATH="$HOME/.local/bin:$PATH"

验证安装：

uvx --version

配置步骤

添加 MCP Server（用户级别）

运行以下命令将 weixin_search 添加为用户级别的 MCP Server（所有项目可用）：

claude mcp add --transport stdio --scope user weixin_search -- uvx weixin_search_mcp --transport stdio

参数说明：

• --transport stdio：使用标准输入/输出通信
• --scope user：用户级别，跨项目生效
• weixin_search：MCP Server 名称

配置会写入 ~/.claude.json，对应的 JSON 结构为：

{
  "mcpServers": {
    "weixin_search": {
      "type": "stdio",
      "command": "uvx",
      "args": ["weixin_search_mcp", "--transport", "stdio"]
    }
  }
}

验证连接

在 Claude Code 中输入 /mcp，应看到 weixin_search 状态为已连接。

原版已知问题（本仓库已修复）

原版 fancyboi999/weixin_search_mcp 存在以下两个问题，本仓库已全部修复，使用本仓库的版本无需手动处理。

问题 1：FastMCP 3.x 兼容性问题

原版依赖 fastmcp>=2.10.4，但 uvx 会安装最新的 fastmcp 3.x，其中 FastMCP() 构造函数不再接受 port 参数，导致启动报错：

TypeError: FastMCP() no longer accepts `port`. Pass `port` to `run_http_async()`, or set FASTMCP_PORT.

修复：移除 FastMCP() 构造函数中的 port=args.port 参数（port 仅在 http 模式的 run() 调用时传入即可）。

问题 2：SOCKS 代理缺少依赖

如果系统配置了 SOCKS 代理（如 ClashX、Surge 等），会报错：

Using SOCKS proxy, but the 'socksio' package is not installed.

修复：在 pyproject.toml 的 dependencies 中添加 httpx[socks]>=0.27.0。

使用方式

配置完成并重启 Claude Code 后，可直接在对话中使用：

• 搜索文章：「帮我搜索关于 xxx 的微信公众号文章」
• 读取全文：「读取这篇微信文章 https://mp.weixin.qq.com/s/xxx」

Claude Code MCP 管理命令参考

claude mcp list                        # 列出所有已配置的 MCP Server
claude mcp get <name>                  # 查看指定 Server 详情
claude mcp remove <name>               # 移除指定 Server
claude mcp add-json <name> '<json>'    # 通过 JSON 添加 Server

Scope 选项：

• --scope user：用户级别，跨项目生效，存储在 ~/.claude.json
• --scope project：项目级别，存储在项目根目录的 .mcp.json
• --scope local：本地级别（默认），存储在 ~/.claude.json 的项目路径下