知识星球内容发布服务

知识星球 MCP 服务器是一个通过 Model Context Protocol 自动发布内容到知识星球的工具,支持文字、图片发布、定时任务管理等功能。

  • by elexingyu
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 elexingyu/zsxq-mcp

使用说明

ZSXQ MCP Server

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

🔥 核心功能

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

📦 安装与配置

1. 安装 uv 工具(首次使用)

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

2. Claude Desktop 配置

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

{
  "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 时,每次调用需手动指定

📁 开发相关

本地开发

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

调试工具

# 使用 MCP Inspector 调试(uvx 方式)
npx @modelcontextprotocol/inspector uvx zsxq-mcp server

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

📄 许可证

MIT License