Skip to main content
Glama
chemany
by chemany
README.md
# 知乎MCP服务器

简单的知乎发布HTTP API服务器,采用和小红书、头条相同的简化架构。

## 功能特性

- ✅ **简单HTTP API**:避免复杂的MCP协议,使用直观的REST API
- 📝 **文章发布**:支持创建和发布知乎文章
- 💬 **回答发布**:支持回答知乎问题
- 📚 **专栏管理**:支持创建知乎专栏
- 🖼️ **图片上传**:支持文章和回答中的图片
- 🔐 **自动登录**:支持Selenium自动化登录
- 🍪 **会话保持**:自动保存和恢复登录状态

## API接口

### 健康检查
```http
GET /zhihu-mcp-server/health
```

### 创建文章
```http
POST /zhihu-mcp-server/create_article
Content-Type: application/json

{
    "title": "文章标题",
    "content": "文章内容",
    "images": ["图片路径1", "图片路径2"],
    "tags": ["标签1", "标签2"],
    "column_id": "专栏ID(可选)",
    "cover_image": "封面图片路径(可选)"
}
```

### 创建回答
```http
POST /zhihu-mcp-server/create_answer
Content-Type: application/json

{
    "question_id": "问题ID或URL",
    "content": "回答内容",
    "images": ["图片路径1", "图片路径2"],
    "is_anonymous": false
}
```

### 创建专栏
```http
POST /zhihu-mcp-server/create_column
Content-Type: application/json

{
    "title": "专栏标题",
    "description": "专栏描述",
    "cover_image": "封面图片路径(可选)"
}
```

## 安装和使用

1. **安装依赖**:
```bash
pip install -r requirements.txt
```

2. **启动服务器**:
```bash
python zhihu_http_api_server.py
```

3. **服务器地址**:
- 默认端口:8005
- 健康检查:http://localhost:8005/zhihu-mcp-server/health

## 端口配置

- 🔴 小红书MCP服务器:8002端口
- 🟠 今日头条HTTP API服务器:8003端口  
- 🔵 **知乎HTTP API服务器:8005端口**

## 注意事项

1. **Chrome驱动**:需要安装Chrome浏览器和对应的ChromeDriver
2. **首次使用**:首次启动时需要手动登录知乎账号
3. **会话保持**:登录状态会自动保存,无需重复登录
4. **图片上传**:确保图片文件路径正确且文件存在

## 项目结构

```
zhihu_mcp_server/
├── zhihu_http_api_server.py     # HTTP API服务器主文件
├── zhihu_mcp_server/            # 核心功能包
│   ├── __init__.py             # 包初始化文件
│   ├── auth.py                 # 认证管理模块
│   └── publisher.py            # 发布功能模块
├── requirements.txt            # 依赖包列表
└── README.md                  # 说明文档
```

## 架构特点

采用了和小红书、头条相同的简化架构:
- **简单HTTP API** → **直接功能调用** → **简单JSON响应**
- 避免了复杂的MCP协议、会话管理、Streamable-HTTP等复杂性
- 提供了稳定可靠的发布服务