# Gemini CLI 配置示例
## 完整配置
将以下配置添加到 Gemini CLI 配置文件中:
```json
{
"mcpServers": {
"xiaohongshu": {
"url": "http://localhost:18060/mcp",
"transport": "streamable-http",
"description": "小红书自动化工具 - 支持发布、评论、点赞等 13 个功能"
}
}
}
```
## 配置说明
| 字段 | 值 | 说明 |
|------|-----|------|
| `url` | `http://localhost:18060/mcp` | MCP 服务器端点 |
| `transport` | `streamable-http` | **必须使用此传输类型** |
| `description` | 描述文本 | 可选,用于说明服务器功能 |
## 使用前检查
1. **启动服务**:
```bash
python main.py
```
2. **测试连接**:
```bash
curl -X POST http://localhost:18060/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'
```
3. **查看工具列表**:
```bash
curl -X POST http://localhost:18060/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}'
```
## 可用工具
配置成功后,可以在 Gemini CLI 中使用以下工具:
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: 检查登录状态
```
请检查小红书登录状态
```
### 示例 2: 发布内容
```
请帮我发布一条小红书内容:
标题: 美食分享
内容: 今天做了好吃的蛋糕
图片: /path/to/cake.jpg
标签: 美食, 烘焙, 蛋糕
```
### 示例 3: 搜索内容
```
请在小红书搜索"美食"相关内容
```
### 示例 4: 获取 Feed 列表
```
请获取小红书首页的 Feed 列表
```
## 常见问题
### Q: 配置文件在哪里?
A: 查看 Gemini CLI 文档,通常在 `~/.config/gemini-cli/` 目录下
### Q: 如何确认配置成功?
A: 在 Gemini CLI 中输入 "请检查小红书登录状态",如果返回结果则配置成功
### Q: 服务器必须一直运行吗?
A: 是的,使用前需要先启动服务器: `python main.py`
### Q: 可以远程访问吗?
A: 默认监听 `0.0.0.0`,可以远程访问。如果只需本地使用,建议在 `.env` 中设置 `HOST=127.0.0.1`
## 故障排除
### 错误: "Method Not Allowed"
**解决**: 确保使用 `/mcp` 端点,不是 `/sse`
### 错误: "Connection refused"
**解决**:
```bash
# 确认服务运行
ps aux | grep "python main.py"
# 启动服务
python main.py
```
### 错误: "Streamable HTTP error"
**解决**: 确保配置中使用 `"transport": "streamable-http"`
## 高级配置
### 使用自定义端口
1. 修改 `.env`:
```bash
PORT=8080
```
2. 更新配置:
```json
{
"mcpServers": {
"xiaohongshu": {
"url": "http://localhost:8080/mcp",
"transport": "streamable-http"
}
}
}
```
### 使用 HTTPS
如果配置了 HTTPS:
```json
{
"mcpServers": {
"xiaohongshu": {
"url": "https://your-domain.com/mcp",
"transport": "streamable-http"
}
}
}
```
## 相关文档
- [Gemini CLI 完整指南](GEMINI_CLI_GUIDE.md)
- [Streamable HTTP 实现](STREAMABLE_HTTP_COMPLETE.md)
- [MCP 使用指南](MCP_GUIDE.md)
- [快速参考](QUICK_REF.md)
---
**最后更新**: 2026-01-17
**版本**: 1.0.3
