通过配置 weixin_search_mcp 这个 MCP Server，可以让 Claude Code 直接搜索微信公众号文章并读取全文内容。该工具基于搜狗微信搜索接口，提供两个核心能力：
本仓库 fork 自 fancyboi999/weixin_search_mcp，已修复 FastMCP 3.x 兼容性问题和 SOCKS 代理缺少依赖的问题，可直接使用。
uv 是现代 Python 包管理工具，它提供的 uvx 命令可以免虚拟环境直接运行 Python 工具。
curl -LsSf https://astral.sh/uv/install.sh | sh
安装完成后，uv 和 uvx 会被安装到 ~/.local/bin/。
确保 ~/.local/bin 在 PATH 中，可在 中添加：
~/.zshrcexport PATH="$HOME/.local/bin:$PATH"
验证安装：
uvx --version
运行以下命令将 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 存在以下两个问题，本仓库已全部修复，使用本仓库的版本无需手动处理。
原版依赖 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() 调用时传入即可）。
如果系统配置了 SOCKS 代理（如 ClashX、Surge 等），会报错：
Using SOCKS proxy, but the 'socksio' package is not installed.
修复：在 pyproject.toml 的 dependencies 中添加 httpx[socks]>=0.27.0。
配置完成并重启 Claude Code 后，可直接在对话中使用：
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 的项目路径下