zsxq-mcp

zsxq-mcp

知识星球 MCP (Model Context Protocol) 服务，让 AI 助手能够操作知识星球。

项目简介

本项目参考 xiaohongshu-mcp 的技术方案，为知识星球（wx.zsxq.com）实现了一个 MCP 服务外壳。

主要功能

1. 登录状态检查 - 检查知识星球登录状态
2. 获取登录二维码 - 获取微信扫码登录的二维码
3. 获取星球列表 - 获取我加入的知识星球列表
4. 获取主题列表 - 获取指定星球内的主题/帖子列表
5. 获取主题详情 - 获取主题的详细内容和评论
6. 搜索主题 - 在指定星球内搜索主题
7. 发布内容 - 发布内容到知识星球
8. 发表评论 - 在主题下发表评论
9. 点赞主题 - 为主题点赞

快速开始

1. 安装依赖

确保你已安装 Go 1.22+

go mod tidy

2. 登录

首次使用需要进行登录，保存知识星球的登录状态：

go run cmd/login/main.go

在打开的浏览器窗口中使用微信扫码登录。

3. 启动 MCP 服务

# 默认无头模式
go run .

# 非无头模式（有浏览器界面）
go run . -headless=false

# 指定端口
go run . -port=:18061

服务将运行在：http://localhost:18061/mcp

MCP 客户端接入

Claude Code CLI

# 添加 HTTP MCP 服务器
claude mcp add --transport http zsxq-mcp http://localhost:18061/mcp

# 检查 MCP 是否添加成功
claude mcp list

Cursor

创建 .cursor/mcp.json：

{
  "mcpServers": {
    "zsxq-mcp": {
      "url": "http://localhost:18061/mcp",
      "description": "知识星球 MCP 服务"
    }
  }
}

VSCode

创建 .vscode/mcp.json：

{
  "servers": {
    "zsxq-mcp": {
      "url": "http://localhost:18061/mcp",
      "type": "http"
    }
  }
}

可用 MCP 工具

使用示例

检查登录状态

帮我检查知识星球的登录状态

获取星球列表

获取我加入的知识星球列表

获取主题列表

获取星球 123456 的最新主题

发布内容

帮我在星球 123456 发布一条内容：今天天气真好！

项目结构

zsxq-mcp/
├── main.go                 # 入口
├── app_server.go           # 应用服务器
├── mcp_server.go           # MCP 服务器和工具注册
├── mcp_handlers.go         # MCP 工具处理逻辑
├── service.go              # 业务服务层
├── types.go                # 类型定义
├── go.mod                  # Go 模块
├── browser/
│   └── browser.go          # 浏览器封装
├── cookies/
│   └── cookies.go          # Cookie 管理
├── configs/
│   └── config.go           # 配置
├── zsxq/                   # 知识星球操作
│   ├── login.go            # 登录
│   ├── groups.go           # 星球列表
│   ├── topics.go           # 主题/帖子
│   ├── publish.go          # 发布内容
│   ├── comment.go          # 评论
│   └── types.go            # 类型
└── cmd/
    └── login/
        └── main.go         # 登录工具

技术栈

• Go 1.22+
• MCP Go SDK - github.com/modelcontextprotocol/go-sdk
• Rod - 浏览器自动化 github.com/go-rod/rod
• Gin - HTTP 服务器 github.com/gin-gonic/gin
• Logrus - 日志 github.com/sirupsen/logrus

风险说明

1. 本项目基于学习目的，禁止一切违法行为
2. 请遵守知识星球的使用规范
3. 建议使用专门的账号进行测试

致谢

• xiaohongshu-mcp - 参考项目

License

MIT