WeChat Article Reader MCP Server

# 微信公众号文章MCP服务器快速启动指南 ## 启动方法 ### 方法1: 使用启动脚本（推荐） #### macOS/Linux ```bash cd mcp-server-wechat chmod +x start_server.sh ./start_server.sh ``` #### Windows ```cmd cd mcp-server-wechat start_server.bat ``` ### 方法2: 手动启动 1. 激活虚拟环境： ```bash # macOS/Linux source ../.venv/bin/activate # Windows ..\.venv\Scripts\activate.bat ``` 2. 检查并安装依赖： ```bash pip install -r requirements.txt playwright install chromium ``` 3. 启动服务器： ```bash python main.py --mode stdio --log-level INFO ``` ## 配置选项 可以通过以下参数自定义服务器行为： - `--mode`: 运行模式 (stdio/http，默认为stdio) - `--log-level`: 日志级别 (DEBUG/INFO/WARNING/ERROR，默认为INFO) - `--config`: 配置文件路径（可选） 示例： ```bash python main.py --mode stdio --log-level DEBUG ``` ## 环境变量配置 可以通过环境变量配置服务器： ```bash export BROWSER_HEADLESS=true export BROWSER_TIMEOUT=30 export REQUEST_TIMEOUT=30 export REQUEST_MAX_RETRIES=3 ``` ## 常见问题 ### 1. 找不到playwright ```bash pip install playwright>=1.40.0 playwright install chromium ``` ### 2. 依赖安装失败 ```bash pip install --upgrade pip pip install -r requirements.txt ``` ### 3. 虚拟环境问题 如果虚拟环境有问题，可以重新创建： ```bash cd .. python -m venv .venv source .venv/bin/activate # Linux/Mac # 或 .venv\Scripts\activate.bat # Windows cd mcp-server-wechat pip install -r requirements.txt playwright install chromium ``` ## 验证服务器 服务器启动后，可以通过以下方式验证： 1. 检查日志输出是否正常 2. 使用MCP客户端连接服务器 3. 调用工具测试功能 ## 服务器工具 服务器提供以下MCP工具： 1. `fetch_article` - 获取微信公众号文章内容 2. `search_articles` - 搜索微信公众号文章 3. `extract_article_summary` - 提取文章摘要 详细使用方法请参考README.md文件。