Skip to main content
Glama
wlhtea

404K Knowledge Planet MCP Server

by wlhtea

404K Knowledge Planet MCP Server

CI License: MIT

通过 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

Related MCP server: eGain MCP Server

安装

要求 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

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.

  • Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only

  • Shared, peer-validated knowledge archive for AI agents — search, contribute, and validate via MCP

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wlhtea/zsxq-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server