404K Knowledge Planet MCP Server

通过 Model Context Protocol（MCP）让 Claude Desktop、Codex、Cursor 和其他 MCP 客户端读取 404k.wlhtea.xyz 上的私有知识星球归档。

MCP Server 不持有知识星球 Cookie，也不直接访问知识星球。它只使用独立的 API Token 请求：

https://404k.wlhtea.xyz/api/v1

功能

• 查看最近同步状态和当前话题数量；
• 分页浏览历史话题；
• 搜索标题和正文；
• 筛选精华、图片和附件；
• 按话题 ID 获取完整正文；
• 返回本站受保护的图片、PDF 和附件地址；
• 所有请求通过 Authorization: Bearer 鉴权。

提供的工具：

zsxq_status
zsxq_list_topics
zsxq_search_topics
zsxq_get_topic

安装

要求 Node.js 20 或更高版本。

从 GitHub 安装：

git clone https://github.com/wlhtea/zsxq-mcp-server.git
cd zsxq-mcp-server
npm ci
npm link

从发布的 .tgz 安装：

npm install -g ./wlhtea-zsxq-mcp-server-1.0.0.tgz

本仓库内直接运行：

cd mcp-server
npm ci
ZSXQ_API_TOKEN="YOUR_API_TOKEN" npm start

环境变量

名称	必填	默认值	说明
ZSXQ_API_TOKEN	是	无	朋友专用 API Token
ZSXQ_API_BASE_URL	否	https://404k.wlhtea.xyz	数据 API 所在网站
ZSXQ_API_TIMEOUT_MS	否	30000	单次请求超时

不要把真实 Token 提交到 Git；.env.example 只保留占位符。

Claude Desktop 配置

{
  "mcpServers": {
    "zsxq-404k": {
      "command": "node",
      "args": ["/ABSOLUTE_PATH/zsxq-mcp-server/src/index.js"],
      "env": {
        "ZSXQ_API_BASE_URL": "https://404k.wlhtea.xyz",
        "ZSXQ_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Codex 配置

安装后可以直接注册到 Codex：

codex mcp add zsxq-404k \
  --env ZSXQ_API_BASE_URL=https://404k.wlhtea.xyz \
  --env ZSXQ_API_TOKEN=YOUR_API_TOKEN \
  -- zsxq-mcp-server

也可以在 ~/.codex/config.toml 中添加：

[mcp_servers.zsxq-404k]
command = "node"
args = ["/ABSOLUTE_PATH/zsxq-mcp-server/src/index.js"]

[mcp_servers.zsxq-404k.env]
ZSXQ_API_BASE_URL = "https://404k.wlhtea.xyz"
ZSXQ_API_TOKEN = "YOUR_API_TOKEN"

验证：

codex mcp get zsxq-404k
codex mcp list

API 调试

curl 'https://404k.wlhtea.xyz/api/v1/status' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

curl 'https://404k.wlhtea.xyz/api/v1/topics?offset=0&limit=20' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

curl 'https://404k.wlhtea.xyz/api/v1/topics?q=AI&limit=20' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

OpenAPI 3.1 文档：

https://404k.wlhtea.xyz/api/v1/openapi.json

OpenAPI 文档本身也需要相同的 Bearer Token。

测试

npm test

License

MIT

Security

MCP Server 只需要 ZSXQ_API_TOKEN，不需要也不接受知识星球 Cookie。不要把 真实 Token 提交到 Git、Issue、日志或截图中，详见 SECURITY.md。