SERVER_STARTUP.md•2.63 kB
# 微信公众号文章MCP服务器启动指南
## 概述
微信公众号文章MCP服务器已经准备就绪,可以通过以下方式启动。
## 快速启动
### 方法1: 使用启动脚本(推荐)
1. 打开终端,进入项目目录:
```bash
cd /Users/wanghao/Documents/trae_projects/MCP101Demo/mcp-server-wechat
```
2. 首次运行需要安装依赖:
```bash
chmod +x install_dependencies.sh
./install_dependencies.sh
```
3. 启动服务器:
```bash
chmod +x start_server.sh
./start_server.sh
```
### 方法2: 手动启动
1. 激活虚拟环境:
```bash
source ../.venv/bin/activate
```
2. 安装依赖(如果尚未安装):
```bash
pip install -r requirements.txt
playwright install chromium
```
3. 启动服务器:
```bash
python main.py --mode stdio --log-level INFO
```
## MCP配置
服务器已添加到MCP配置文件中,配置位置:
`/Users/wanghao/Documents/trae_projects/MCP101Demo/mcp-config.json`
配置内容:
```json
"wechat-article-mcp": {
"command": "/Users/wanghao/Documents/trae_projects/MCP101Demo/.venv/bin/python",
"args": ["/Users/wanghao/Documents/trae_projects/MCP101Demo/mcp-server-wechat/main.py", "--mode", "stdio"],
"env": {
"PYTHONPATH": "/Users/wanghao/Documents/trae_projects/MCP101Demo/mcp-server-wechat"
}
}
```
## 服务器功能
服务器提供以下MCP工具:
1. **fetch_article** - 获取微信公众号文章内容
- 输入:文章URL
- 输出:文章内容、元数据和统计信息
2. **search_articles** - 搜索微信公众号文章
- 输入:搜索关键词
- 输出:匹配的文章列表
3. **extract_article_summary** - 提取文章摘要
- 输入:文章URL
- 输出:文章摘要
## 验证服务器
服务器启动后,可以通过以下方式验证:
1. 检查日志输出是否正常
2. 使用MCP客户端连接服务器
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
cd mcp-server-wechat
pip install -r requirements.txt
playwright install chromium
```
## 下一步
1. 启动服务器
2. 在MCP客户端中连接服务器
3. 使用提供的工具获取微信公众号文章内容
详细文档请参考:
- README.md - 完整项目文档
- API.md - API文档
- DEVELOPMENT.md - 开发指南