知识星球 MCP (Model Context Protocol) 服务，让 AI 助手能够操作知识星球。
本项目参考 xiaohongshu-mcp 的技术方案，为知识星球（wx.zsxq.com）实现了一个 MCP 服务外壳。
主要功能
- 登录状态检查 - 检查知识星球登录状态
- 获取登录二维码 - 获取微信扫码登录的二维码
- 获取星球列表 - 获取我加入的知识星球列表
- 获取主题列表 - 获取指定星球内的主题/帖子列表
- 获取主题详情 - 获取主题的详细内容和评论
- 搜索主题 - 在指定星球内搜索主题
- 发布内容 - 发布内容到知识星球
- 发表评论 - 在主题下发表评论
- 点赞主题 - 为主题点赞
确保你已安装 Go 1.22+
go mod tidy首次使用需要进行登录，保存知识星球的登录状态：
go run cmd/login/main.go在打开的浏览器窗口中使用微信扫码登录。
# 默认无头模式
go run .
# 非无头模式（有浏览器界面）
go run . -headless=false
# 指定端口
go run . -port=:18061服务将运行在：http://localhost:18061/mcp
# 添加 HTTP MCP 服务器
claude mcp add --transport http zsxq-mcp http://localhost:18061/mcp
# 检查 MCP 是否添加成功
claude mcp list创建 .cursor/mcp.json：
{
"mcpServers": {
"zsxq-mcp": {
"url": "http://localhost:18061/mcp",
"description": "知识星球 MCP 服务"
}
}
}创建 .vscode/mcp.json：
{
"servers": {
"zsxq-mcp": {
"url": "http://localhost:18061/mcp",
"type": "http"
}
}
}| 工具名称 | 描述 | 参数 |
|---|---|---|
check_login_status |
检查知识星球登录状态 | 无 |
get_login_qrcode |
获取登录二维码 | 无 |
delete_cookies |
删除 cookies，重置登录状态 | 无 |
list_groups |
获取我加入的星球列表 | 无 |
list_topics |
获取星球内主题列表 | group_id |
get_topic_detail |
获取主题详情 | topic_id |
search_topics |
搜索主题 | group_id, keyword |
publish_content |
发布内容 | group_id, content, images? |
post_comment |
发表评论 | topic_id, content |
like_topic |
点赞主题 | topic_id |
帮我检查知识星球的登录状态
获取我加入的知识星球列表
获取星球 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
- 本项目基于学习目的，禁止一切违法行为
- 请遵守知识星球的使用规范
- 建议使用专门的账号进行测试
- xiaohongshu-mcp - 参考项目
MIT