# Gemini CLI 配置指南
## 概述
本指南说明如何在 Gemini CLI 中配置小红书 MCP 服务器。
**✅ 已支持 Streamable HTTP 传输协议**
## 前提条件
1. **启动 HTTP 服务器**:
```bash
python main.py
```
2. **确认服务正常**:
```bash
curl http://localhost:18060/health
# 应该返回: {"status":"ok"}
```
## 配置方法
### 推荐配置: Streamable HTTP
在 Gemini CLI 配置文件中添加:
```json
{
"mcpServers": {
"xiaohongshu": {
"url": "http://localhost:18060/mcp",
"transport": "streamable-http"
}
}
}
```
**注意**:
- 使用 `streamable-http` 作为传输类型
- 端点为 `/mcp`
- 服务器会返回流式 JSON 响应
```json
{
"mcpServers": {
"xiaohongshu": {
"command": "python",
"args": [
"/Users/xjp/Documents/project/xiaohongshu/xiaohongshu-python/mcp_stdio.py"
],
"env": {
"PYTHONPATH": "/Users/xjp/Documents/project/xiaohongshu/xiaohongshu-python",
"HEADLESS": "true"
}
}
}
}
```
**注意**: 请将路径替换为你的实际项目路径。
## 测试连接
### 1. 测试 HTTP 端点
```bash
curl -X POST http://localhost:18060/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "initialize",
"params": ,
"id": 1
}'
```
**预期响应**:
```json
{
"jsonrpc": "2.0",
"result": {
"protocolVersion": "2024-11-05",
"capabilities": {
"tools": {}
},
"serverInfo": {
"name": "xiaohongshu-mcp",
"version": "1.0.0"
}
}
}
```
### 2. 在 Gemini CLI 中测试
配置完成后,在 Gemini CLI 中:
```
请检查小红书登录状态
请帮我发布一条小红书内容
```
## 可用工具
配置成功后,可以使用以下 13 个工具:
1. `check_login_status` - 检查登录状态
2. `get_login_qrcode` - 获取登录二维码
3. `delete_cookies` - 删除 cookies
4. `list_feeds` - 获取 Feed 列表
5. `search_feeds` - 搜索内容
6. `get_feed_detail` - 获取 Feed 详情
7. `post_comment_to_feed` - 发表评论
8. `reply_comment_in_feed` - 回复评论
9. `like_feed` - 点赞/取消点赞
10. `favorite_feed` - 收藏/取消收藏
11. `user_profile` - 获取用户主页
12. `publish_content` - 发布图文内容
13. `publish_with_video` - 发布视频内容
## 故障排除
### 问题 1: "Method Not Allowed" 错误
**原因**: 旧版本的端点不支持 POST 方法
**解决**:
1. 确保使用最新版本的代码
2. 重启服务: `kill $(cat server.pid) && python main.py`
3. 使用 `/mcp` 端点而不是 `/sse`
### 问题 2: 连接超时
**检查**:
```bash
# 确认服务运行
ps aux | grep "python main.py"
# 确认端口监听
lsof -i:18060
# 测试端点
curl http://localhost:18060/mcp
```
**解决**:
1. 确保服务已启动
2. 检查防火墙设置
3. 确认端口未被占用
### 问题 3: 工具未发现
**检查日志**:
```bash
tail -f server.log | grep MCP
```
**应该看到**:
```
Registering MCP tools...
All 13 MCP tools registered successfully
```
**解决**:
1. 重启服务
2. 检查 MCP 工具注册是否成功
3. 查看详细日志
### 问题 4: 浏览器启动失败
**检查**:
```bash
# 测试浏览器配置
python test_browser_config.py
```
**解决**:
1. 确认 Chrome 浏览器路径正确
2. 安装 Playwright: `playwright install chromium`
3. 检查 `.env` 配置
## 配置示例
### 完整的 Gemini CLI 配置
```json
{
"mcpServers": {
"xiaohongshu": {
"url": "http://localhost:18060/mcp",
"transport": "http",
"description": "小红书自动化工具 - 支持发布、评论、点赞等功能"
}
}
}
```
### 环境变量配置 (`.env`)
```bash
# 服务器配置
HOST=0.0.0.0
PORT=18060
# 浏览器配置
HEADLESS=false
BROWSER_BIN_PATH=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
# 反检测配置
ENABLE_STEALTH=true
MIN_ACTION_DELAY=2000
MAX_ACTION_DELAY=5000
DAILY_PUBLISH_LIMIT=10
# Cookie 配置
COOKIES_PATH=./data/cookies.json
# 日志配置
LOG_LEVEL=INFO
```
## 使用示例
### 示例 1: 检查登录状态
在 Gemini CLI 中:
```
请检查小红书登录状态
```
### 示例 2: 发布内容
```
请帮我发布一条小红书内容:
标题: 美食分享
内容: 今天做了好吃的蛋糕
图片: /path/to/cake.jpg
标签: 美食, 烘焙, 蛋糕
```
### 示例 3: 搜索内容
```
请在小红书搜索"美食"相关内容
```
## 性能优化
### 1. 使用 Headless 模式
在 `.env` 中设置:
```bash
HEADLESS=true
```
这样可以减少资源占用,提高响应速度。
### 2. 调整延迟参数
根据需求调整反检测延迟:
```bash
# 更快的响应 (风险较高)
MIN_ACTION_DELAY=1000
MAX_ACTION_DELAY=2000
# 更安全的配置 (响应较慢)
MIN_ACTION_DELAY=3000
MAX_ACTION_DELAY=6000
```
### 3. 限制每日操作
```bash
DAILY_PUBLISH_LIMIT=5
DAILY_COMMENT_LIMIT=30
DAILY_LIKE_LIMIT=50
```
## 安全建议
1. **不要在公网暴露服务**
- 默认监听 `0.0.0.0`,允许外部访问
- 生产环境建议改为 `127.0.0.1`
2. **定期更新 Cookie**
- Cookie 会过期
- 定期重新登录
3. **监控操作频率**
- 避免短时间大量操作
- 遵守平台规则
4. **备份配置**
- 定期备份 `.env` 和 `cookies.json`
- 避免数据丢失
## 相关文档
- [MCP 使用指南](MCP_GUIDE.md)
- [反检测文档](ANTI_DETECTION.md)
- [快速参考](QUICK_REF.md)
- [API 文档](http://localhost:18060/docs)
## 支持的 MCP 客户端
| 客户端 | 协议 | 端点 | 状态 |
|--------|------|------|------|
| Claude Desktop | Stdio | `mcp_stdio.py` | ✅ 支持 |
| Gemini CLI | HTTP | `/mcp` | ✅ 支持 |
| 其他 MCP 客户端 | SSE | `/sse` | ✅ 支持 |
| 自定义客户端 | HTTP API | `/api/v1/*` | ✅ 支持 |
## 获取帮助
如果遇到问题:
1. 查看日志: `tail -f server.log`
2. 运行测试: `python test_mcp.py`
3. 检查配置: 确认 `.env` 和 `mcp_config.json`
4. 阅读文档: 查看相关文档
---
**最后更新**: 2026-01-17
**版本**: 1.0.1
**维护者**: xiaohongshu-python 项目组
