Metadata-Version: 2.4
Name: zsxq-mcp
Version: 0.2.0
Summary: MCP server for publishing content to Zhishixingqiu (知识星球)
Requires-Python: >=3.10
Requires-Dist: fastmcp>=0.2.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# ZSXQ MCP Server

知识星球 MCP 服务器 - 通过 Model Context Protocol 自动发布内容到知识星球。

## 🔥 核心功能

- ✅ 发布文字主题
- ✅ 上传并发布带图片的主题
- ✅ 从本地文件读取内容发布
- ✅ 灵活的环境变量配置
- ✅ Cookie 身份验证
- ✅ 定时发布主题
- ✅ 定时任务管理

## 📦 安装与配置

### 1. 安装 uv 工具（首次使用）

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

### 2. Claude Desktop 配置

直接在配置文件中使用 uvx 运行：

```json
{
  "mcpServers": {
    "zsxq": {
      "command": "uvx",
      "args": ["zsxq-mcp", "server"],
      "env": {
        "ZSXQ_COOKIE": "your_cookie_here",
        "ZSXQ_GROUP_ID": "your_group_id_here"
      }
    }
  }
}
```

重启 Claude Desktop 即可使用。

### 配置说明

| 参数 | 说明 | 必填 |
|------|------|------|
| `ZSXQ_COOKIE` | 知识星球浏览器 Cookie | ✅ |
| `ZSXQ_GROUP_ID` | 星球 ID（URL 中获取） | 🔹 |

> Cookie 获取方法：浏览器登录知识星球 → F12 开发者工具 → Network → 任意 API 请求 → 请求头 `Cookie` 字段

## 🚀 使用示例

### 在 Claude 中使用

```
帮我发布一条动态到知识星球："今天学习了 MCP 的使用方法！"
```

```
把这个文件的内容发布到知识星球：/path/to/article.txt
```

```
帮我发布一条带图片的动态，内容是"分享今天的成果"，图片路径：/path/to/screenshot.png
```

```
帮我定时发布一条动态，5分钟后发布，内容是"定时测试"
```

```
帮我查看所有定时发布的任务
```

### MCP 工具列表

| 工具 | 功能 |
|------|------|
| `publish_topic` | 发布文字主题 |
| `publish_topic_from_file` | 从文件发布内容 |
| `publish_topic_with_images` | 发布带图片的主题 |
| `upload_image` | 单独上传图片 |
| `get_group_info` | 获取星球信息 |
| `schedule_topic` | 定时发布主题 |
| `get_scheduled_jobs` | 获取定时任务列表 |

## 📌 注意事项

- 🔒 Cookie 包含登录凭证，请勿泄露
- ⏰ Cookie 可能过期，需定期更新
- 💡 未指定 `ZSXQ_GROUP_ID` 时，每次调用需手动指定

## 📁 开发相关

### 本地开发

```bash
git clone https://github.com/your-repo/zsxq-mcp.git
cd zsxq-mcp
pip install -e .
```

### 调试工具

```bash
# 使用 MCP Inspector 调试（uvx 方式）
npx @modelcontextprotocol/inspector uvx zsxq-mcp server

# 或本地开发调试
uvx zsxq-mcp server
```

## 📄 许可证

MIT License
