Skip to main content
Glama
coolapk-mcp-pro

coolapk-mcp-pro

by yufeng-liang

酷安 MCP Server(coolapk-mcp-pro)

Python MCP 酷安 License GitHub stars MCP 协议

纯只读的酷安社区资料检索 MCP Server——让任何支持 MCP 的 AI 助手直接检索酷安帖子、话题与用户资料:电脑上的编程工具(dsh / Claude Code / Claude Desktop / Cursor / Cline)、手机上的 AI 助手(RikkaHub / Kelivo / 超级小爱)都可以。

接入哪些客户端

凡是支持 MCP 的客户端都能接入——客户端只负责发起请求,服务端不用为每个客户端改代码。

你的客户端

接入指南

电脑上的编程工具:dsh / Claude Code / Claude Desktop / Cursor / Cline

见 AGENT-SETUP.md,也可以直接把这个文件丢给你的 AI,让它带你跑通(该文档就是写给 agent 读的:AI 读完会主动问你是本地还是服务器、用哪种登录,然后一步步装好并验收)

手机上的 AI 助手:RikkaHub / Kelivo / 超级小爱

手机端跑不了本地进程,只能连远程形态;图文步骤(含导入 JSON、逐项核对、看图兜底、常见故障)见 docs/PHONE-RIKKAHUB.md

🤖 如果你是 AI / agent:先读 AGENT-SETUP.md,按里面的三问确认用户场景,再动手安装。

声明:本项目基于 Lniosy/coolapk-mcp(经 zjy2968466837/coolapk-mcp 增强后平铺引入)二次增强,详见 NOTICE.md。感谢两位上游作者。登录态复用的「酷安桌面端」同样是第三方社区项目,声明见下节。

登录态复用酷安第三方桌面端(见下方准备清单)、失效检测与重登、风控回落、图片读取。Python 3.10+(实测 3.14)+ FastMCP。

仅用于学习与测试,请勿滥用酷安官方接口。本服务不提供任何写操作(点赞 / 回复 / 关注 / 发帖)。

Related MCP server: local-tools-mcp-server

特性

  • 17 个只读工具:搜索、帖子详情、话题、用户资料、用户动态、首页动态、板块、二手、应用详情、通知、图片读取、登录状态、搜索联想词、URL 透传、作者画像、作者深挖聚合、图片外链中转

  • 风控回落:帖子详情接口被验证码拦截时自动改从作者动态列表取全文(fetch_source 字段标注来源),回复走独立接口

  • 请求节制:全局限速(相邻请求 ≥1.2 s)、GET 按 TTL 缓存、瞬态错误指数退避重试、验证码端点负缓存冷却

  • 搜索净化:严格关键词过滤 + 去重 + 疑似广告标记,滤掉酷安搜索混入的不相关结果

  • 登录态增强(0.2.0):auto 模式直接复用酷安第三方桌面端的登录态(官方没有桌面端,此为社区项目),失效时结构化 auth_expired 报错,支持 login --web / --sms / --cookie / --adb 重登

准备清单(开始前先看这个)

酷安官方只有手机 App,没有桌面端。本 MCP 的登录态能力依赖社区维护的第三方桌面客户端,需要自行准备:

你的情况

需要准备

路径一(推荐):安装桌面端

① 下载并安装酷安第三方桌面端(Windows / macOS / Linux / Android / iOS 均有安装包;原项目 daimiaopeng/coolapk-desktop 已归档,由社区组织接续维护)→ ② 打开桌面端完成登录(官方授权页扫码或短信)→ ③ 没了,auto 模式自动复用其登录态

路径二:不装桌面端

① 一个酷安安卓 APK(任意渠道版本,改名 coolapk.apk 放到 ~/.coolapk-mcp/,用于提取签名 blob)→ ② 用下文短信登录或 Cookie 导入建立登录态

说明:桌面端登录解决的是登录态(accounts.json),签名 blob 仍需安卓 APK(见下节前置)——桌面端的 exe/dmg 安装包提不了 blob。已装桌面端的用户可以顺手把手机上的酷安 APK 也放进来,两步就绪。

安装

git clone https://github.com/yufeng-liang/coolapk-mcp-pro.git
cd coolapk-mcp-pro
py -m venv .venv
.venv\Scripts\python -m pip install -e .

快速验证:

.venv\Scripts\coolapk search "Magisk 模块"          # CLI 冒烟
.venv\Scripts\python -m coolapk_mcp.server          # 启动 MCP(stdio,Ctrl+C 退出)

前置:token V3 签名需要设备指纹 blob(~/.coolapk-mcp/auth_blob.bin),仓库不携带该二进制,登录命令本身不会生成 blob。获取方式任选其一:

  1. 把酷安 APK 改名为 coolapk.apk 放到 ~/.coolapk-mcp/,客户端启动后自动提取 blob 并缓存;

  2. 从已有可用环境把 auth_blob.bin 复制到 ~/.coolapk-mcp/。

登录(四通道)

MCP 服务启动即自动管理登录态,无需在客户端配置里塞 Cookie:

方式

命令

说明

auto 模式(默认)

无需操作

优先读酷安第三方桌面端 %APPDATA%\com.coolapk.desktop\accounts.json 中 lastLoginUid 对应账户的完整 Cookie(含 SESSID),无效时回落 ~/.coolapk-mcp/config.json 的原生三键 token;设备码优先复用 accounts.json 的 deviceCode

网页登录

.venv\Scripts\coolapk login --web

拉起系统浏览器(Chrome / Edge)打开酷安授权页,人工完成登录(含滑块 / 验证码)后自动经 CDP 读取 Cookie 写入本地配置,300 秒超时。优先走 CDP 直连浏览器(不依赖 pythonnet,Python 3.14 也可用),本机找不到浏览器时回退 pywebview 窗口(仅 Windows);浏览器路径可用 COOLAPK_BROWSER 指定,已开调试浏览器可设 COOLAPK_CDP_PORT 直连。无图形环境(纯服务器)不可用,此时改用 --sms / --cookie

短信登录

.venv\Scripts\coolapk login --sms --phone <手机号>

按提示两步完成:识别图形验证码 → 提交短信验证码

Cookie 导入

.venv\Scripts\coolapk login --cookie "uid=…;username=…;token=…"

从浏览器或桌面端日志手动粘贴 Cookie

查看登录状态:.venv\Scripts\coolapk login --status,或让 agent 调用 coolapk_login_status 工具。

命令行(coolapk)

服务端工具之外,同一套客户端逻辑也提供命令行入口(输出紧凑 JSON,适合脚本与 agent 直接调)。常用:

命令

作用

coolapk home --tab recommend|follow|hot|latest / main / hot / boards / board / secondhand

首页(recommend 算法推荐、follow 关注流)、热门、板块与二手市场浏览

coolapk feed <id或分享链接>

帖子详情(FEED_ID 可粘整段分享文案),支持 --focus smart|author|hot|all、--focus-page(续抓焦点评论)、--grep、--all-replies、--history、--expand-sub-replies

coolapk search <keyword>

搜索,--type / --sort hot|reply|default / --strict

coolapk user <uid>

用户资料或 --feeds 动态列表

coolapk author <uid>

作者画像:等级、粉丝、专长推断与高分动态(--top N)

coolapk topic <tag> / suggest <词> / app-detail <包名> / notify <类型>

话题、联想词、应用详情、通知

coolapk get-url <路径>

只读透传任意 /v6/ 接口,严格白名单默认开启

coolapk image-link <图片URL...>

生成 /img 签名外链(需 COOLAPK_PUBLIC_BASE)

coolapk login ...

四条登录通道,见上一节

远程部署(coolapk-mcp 服务)才是 agent 的常规接入方式;CLI 主要用于排障、脚本与手工核对。

工具一览

工具

作用

关键参数

coolapk_search

搜索帖子 / 用户 / 话题 / 应用,严格过滤 + 去重 + 广告标记;结果带热度字段、has_more/next_page 续抓信号;结果为空时附 hint 说明原因(被严格过滤 / 只剩卡片广告 / 真没有)

keyword、type=feed|user|feedTopic|app、page、strict、sort=hot|reply|default(默认 hot,结果质量显著更好)

coolapk_feed_detail

帖子详情 + 回复(风控自动回落);评论聚焦与金矿挖掘;正文超长自动截断并标 content_truncated,comment_keyword 按全部已取回复检索后再套条数上限(命中不会被条数截断吃掉),回复超 COOLAPK_REPLY_MAX_ITEMS 条标 replies_omitted(这是本地裁剪,不给 next_page,继续往后看请传 reply_page)

feed_id(数字,或直接粘贴 https://www.coolapk.com/feed/… 分享链接/整段分享文案)、all_replies、comment_keyword、comments_focus(smart=楼主补充+热门评论,找工具/资源首选;author=只看楼主;hot=热门评论;all=全部)、with_history(正文修改历史)、expand_sub_replies(深度展开楼中楼,楼主答疑常在其中)、focus_page(焦点评论起始页,消费上次的 comments_focus.next_page 续抓);输出含 share_url(带分享码的网页链接,人在浏览器打开可看全文,不耗服务器图片流量)

coolapk_topic

话题详情 / 话题下动态(默认按热度排序);详情或动态任一路被风控时降级返回,并在 topic_error / feeds_error 标注原因

tag、with_feeds、page、hot_first(默认 true)

coolapk_user_profile

用户资料

uid

coolapk_user_feeds

用户发布的帖子(支持多页聚合 + 关键词过滤 + 热度排序;撞页数/预算上限时 truncated=true 并用 next_page 续抓)

uid、page、pages=1-5、keyword、sort=default|hot|latest、keyword_mode=any|all(生效值回显在同名字段)

coolapk_home

首页动态,返回 {tab, page, fetched, has_more, next_page, feeds}(未知 tab 归 recommend 并回显 tab_fallback=true)

tab=recommend(算法推荐,/v6/main/indexV8)、follow(只看已关注的人)、hot、latest;page

coolapk_board

板块动态(21 个板块:数码/二手交易/摄影/问答/酷安头条…),支持板块 id 或中文名,未知板块直接报错并列出可用清单;带 has_more/next_page

board(如 digital / 手机 / 二手交易)、page

coolapk_secondhand

二手市场动态,可按品牌过滤;带 has_more/next_page

brand(品牌 id,0=全部)、page

coolapk_app_detail

应用详情(简介、关注数、下载量、版本)

package_name(如 com.coolapk.market)

coolapk_notify

消息通知:@我的、评论我的、赞我的、关注、私信;可选带未读数;带 has_more/next_page

ntype=atMeMeFeed|atComment|comment|feedLike|contactsFollow|message、page、with_count

coolapk_read_image

读取图片消息(带 Referer 下载,解决图片 CDN 直连 567);默认缩略优先(长边 1080px,省 70~80% 流量,COOLAPK_IMG_THUMBNAIL=0 关闭);支持一次多张(九宫格帖一次看全,重复 URL 自动去重)

图片 URL(逗号/空格/换行分隔,最多 9 张)

coolapk_image_link

把酷安图片转成可在任意聊天窗口显示的签名 https 链接(仅远程 HTTP 模式,需 COOLAPK_PUBLIC_BASE)

urls(逗号/空格/换行分隔)、ttl_minutes(默认 120)

coolapk_login_status

查询当前登录态与登录方式

无

coolapk_suggest

搜索联想词(把口语化需求改写成酷安习惯用词)

keyword

coolapk_get_url

只读 GET 透传(访问上表未覆盖的酷安只读接口);严格模式默认开启,只放行形态像只读的末段(detail/list/space/纯数字 id 等),确需透传非常规只读路径时设 COOLAPK_GET_URL_STRICT=0 关闭

接口路径与参数

coolapk_author

作者画像与权威度评分(author_tier / is_expert / fans_per_feed / expertise),判断「这人是不是该领域大佬」

uid

coolapk_author_digest

作者深挖聚合:一次抓多页他的帖子、按主题过滤并按热度排序,拿到完整攻略链;同样带 truncated/next_page 续抓

uid、keyword、pages=1-5(默认 2)、top(默认 10)、keyword_mode=any|all

前 6 个工具基座已实现;coolapk_read_image / coolapk_login_status / coolapk_get_url 为 0.2.0 新增;coolapk_suggest 为 0.4.0 新增;coolapk_author / coolapk_author_digest 为 0.5.0 新增;coolapk_image_link 为 0.6.0 新增;coolapk_board / coolapk_secondhand / coolapk_app_detail / coolapk_notify 为 0.7.0 新增(此前只能靠 coolapk_get_url 手拼路径)。

帖子类结果统一带质量分:post_score(点赞 + 评论×3 + 转发×2)与 discussion_ratio(评论/点赞),可直接用于排序和判断「这条是干货还是凑数」。

所有工具返回 JSON;出错时返回 {"error": "…", "error_type": "…", "code": …},必要时附带 retry_after(建议等待秒数)与 retryable(只有 true 才表示原样重试有意义)。

error_type 取值:

取值

含义

建议动作

api

服务端业务错误

看 error 内容再决定,别原样重试

captcha

风控验证码

等 retry_after 秒,或运行 coolapk login 解锁

auth_expired

登录态失效

引导用户重登,重试无效

risk

风控/频率拦截(HTTP 403 + 风控文案)

等 retry_after 秒再试,不需要重新登录

rate_limit

服务端限流(HTTP 429)

按 retry_after 等待;太久则放弃本轮

network / transient

超时 / 连接失败 / 5xx

可重试(retryable: true;重试前的等待会取退避曲线与 Retry-After 的较大值)

config

本机配置/凭据不可用(缺登录态、缺 libauth blob)

运行 coolapk login 或把酷安 APK 放到 ~/.coolapk-mcp/coolapk.apk

internal

服务端未预期异常

重试无效,把 error 文本回给维护者(堆栈只在服务端日志)

http

其他非 2xx 状态码

多半是参数或路径问题,重试无效

parse

响应不是预期 JSON

多半撞到风控页,换端点或稍后

配置项(环境变量)

变量

默认

说明

COOLAPK_LOGIN_MODE

auto

登录态来源:auto = 优先桌面端 accounts.json,回落本地配置;desktop = 锁定仅用桌面端;native = 仅用本地配置

COOLAPK_MIN_INTERVAL

1.2

相邻 API 请求最小间隔(秒)

COOLAPK_MAX_RETRIES

2

瞬态错误(超时 / 5xx / 429)重试次数

COOLAPK_MAX_BACKOFF

30

单次退避等待上限(秒):重试次数配得很大时,防止一次等上百秒

COOLAPK_RATE_LIMIT_MODE

global

global = 全局串行(最保守,默认,与历史行为一致);bucket = 按资源分桶各自计时,不同端点可并行、同一端点仍串行(延迟更低,瞬时并发数最多等于桶数)

COOLAPK_TOKEN_TTL

60

X-App-Token 复用窗口(秒):一次 v3 生成约 60ms 纯 CPU,窗口内复用;设 0 则每次重算(排障用)

COOLAPK_INDEX_SAVE_DELAY

1

uid_index.json 落盘合并窗口(秒):窗口内的新 id 累积成一次写盘,退出前自动刷盘

COOLAPK_GET_URL_STRICT

1

coolapk_get_url 严格模式(默认开启):在写端点黑名单之上再加正向白名单,只放行末段形态像只读端点的路径(detail/list/info/space/search…)或以纯数字 id 结尾的路径,未知的新写端点也进不来。设为 0 才回到黑名单模式,保留「透传任意只读路径」的逃生舱

COOLAPK_PAGE_SIZE

10

分页接口的「短页即末页」判定阈值:某页返回条数小于该值即认为到底。接口页大小改版时调这个,不用改代码

COOLAPK_NO_CACHE

未设

设为 1 禁用 GET 缓存(调试用)

COOLAPK_CACHE_MAX_BYTES

8388608

GET 缓存总字节上限(默认 8 MB):除条数上限外再按体积淘汰,避免几条超长评论列表把常驻内存顶高

COOLAPK_MAX_REPLY_PAGES

30

all_replies 全量评论翻页上限(1-100,大帖防刷屏防风控)

COOLAPK_FEED_CONTENT_MAX

2000

单条正文最大字符数:超出截断并在结果里置 content_truncated: true(用 coolapk_get_url 或 share_url 取全文);设 0 不限制

COOLAPK_REPLY_CONTENT_MAX

800

单条评论最大字符数,同上标 content_truncated;设 0 不限制

COOLAPK_REPLY_MAX_ITEMS

60

单次返回的评论条数上限(all_replies 一条帖能翻 300 条,整份塞进上下文会挤掉后续对话):超出保留前 N 条并置 replies_omitted;设 0 不限制

COOLAPK_BROWSER

未设

指定浏览器可执行文件路径(coolapk login --web 用);不设则自动查找 Chrome / Edge

COOLAPK_CDP_PORT

未设

连接已在运行的浏览器调试端口(需该浏览器带 --remote-debugging-port 启动);设置后 --web 不再自己拉起浏览器

COOLAPK_IMG_THUMBNAIL

1

图片缩略优先开关(默认开):coolapk_read_image 与 /img 中转对带尺寸后缀的图先取酷安服务端缩略 .m.jpg(长边约 1080px,仍在多模态模型视觉窗口内,大图省约 70~80% 流量),上游非 200 自动回落原图;设 0 关闭

COOLAPK_IMG_SECRET

未设

/img 中转与 coolapk_image_link 的 HMAC 签名密钥。不设时随机生成并持久化到 ~/.coolapk-mcp/img_secret(POSIX 权限 600);不复用 COOLAPK_HTTP_TOKEN,也不再有硬编码默认值

COOLAPK_PUBLIC_BASE

未设

远程 HTTP 模式下的对外访问前缀(如 https://mcp.example.com)。设置后 coolapk_image_link 才能生成图片外链,/img 中转也随之生效

COOLAPK_LOG_JSON

未设

设为 1 时日志改为 JSON Lines 输出到 stderr(ts/level/logger/msg,异常时多一个 exc 只留最后一行),供容器与采集器按行解析;stdio 下 stdout 让给协议帧,日志一律走 stderr;httpx/mcp/uvicorn 固定压到 WARNING,避免带凭据的请求 URL 落进日志

COOLAPK_LOG_LEVEL

INFO

仅在开启 COOLAPK_LOG_JSON 时生效的根日志级别(DEBUG/INFO/WARNING…)

数据文件(自动生成,勿提交仓库):~/.coolapk-mcp/config.json(设备码与登录态)、~/.coolapk-mcp/uid_index.json(feed_id → 作者 uid 索引,供详情回落)。

Agent 接入

如果你是 AI / agent,请直接读 AGENT-SETUP.md——面向 agent 的完整自助指南:自检环境 → 问清部署形态 → 安装 → 建立登录态 → 写客户端配置 → 五项验收,照做即可完成接入,不需要用户手敲命令。

人读速查(stdio 本地形态,路径换成实际克隆目录):

Claude Desktop(%APPDATA%\Claude\claude_desktop_config.json,Windows 路径 JSON 内用 \\ 转义):

编辑 %APPDATA%\Claude\claude_desktop_config.json(Windows 路径 JSON 内用 \\ 转义):

{
  "mcpServers": {
    "coolapk": {
      "command": "D:\\coolapk-mcp-pro\\.venv\\Scripts\\python.exe",
      "args": ["-m", "coolapk_mcp.server"]
    }
  }
}

Cursor

编辑项目或全局 .cursor/mcp.json(正斜杠路径即可):

{
  "mcpServers": {
    "coolapk": {
      "command": "D:/coolapk-mcp-pro/.venv/Scripts/python.exe",
      "args": ["-m", "coolapk_mcp.server"]
    }
  }
}

凡是支持 MCP 的客户端都能接入,包括手机上的 AI 助手(超级小爱、RikkaHub、Kelivo 等)——手机端通常只能连接远程形态,需要先按远程部署把服务跑起来,具体步骤(含导入 JSON、截图与逐项核对)见手机端接入指南(以 RikkaHub 为例);远程客户端写法见「远程部署 → 客户端接入」,其余桌面客户端按 stdio 三要素(command 指向 venv 的 python、args 为 ["-m", "coolapk_mcp.server"])自行适配,dsh 的 cordis.patch.yml 片段见 AGENT-SETUP.md。

远程部署

前面的「Agent 接入」示例都是 stdio 形态:MCP 进程跑在本机、随客户端会话启动退出。如果你有一台云服务器,想让家里和公司的电脑、多台设备甚至多个同事共用同一个部署(登录态与缓存也只有一份),就把服务跑成远程形态:服务端以 streamable-http 启动,客户端通过 URL + Bearer Token 远程连接。

快速启动

本节命令为 Linux(bash)服务器 写法(远程部署的目标环境即 Linux 服务器);Windows 的本地安装与 stdio 接入见安装与「Agent 接入」两节。

python3 -m venv .venv
.venv/bin/python -m pip install -e .

# 生成一个随机 token(服务端与客户端共用)
python3 -c "import secrets; print(secrets.token_urlsafe(32))"

# 四个环境变量,然后启动
export COOLAPK_MCP_TRANSPORT=streamable-http   # 启用远程形态(http / streamable_http 别名等效)
export COOLAPK_HTTP_HOST=127.0.0.1             # 一般绑回环,由反代对外;确要直连公网见下方安全一节
export COOLAPK_HTTP_PORT=8000
export COOLAPK_HTTP_TOKEN=<上一步生成的随机串>

.venv/bin/coolapk-mcp

启动后先自检:curl http://127.0.0.1:8000/health 返回 {"status":"ok"} 即说明服务已就绪(该端点免鉴权,仅供探活);MCP 端点在 /mcp,一律要求 Bearer Token。

需要看运行状况时用 /status(同样要求 Bearer Token):一次返回 version、uptime_s、login(是否登录/uid/来源)、rate_limit(模式与间隔)、cache(条数/字节/命中/淘汰)、requests(累计请求、重试、缓存命中/未命中、单飞搭车、calls 与 latency_ms.total|max|avg、按 error_type 的错误分布,非 CoolapkError 记为 internal:<异常类名>)与 image(中转大小上限)。配置损坏或客户端初始化失败时返回 {"status":"degraded","version":…,"error":…}(HTTP 仍 200),探针据此区分「活着但坏了」与「进程没了」。/health 保持极简——容器探针不该触发任何磁盘或网络动作。

curl -H "Authorization: Bearer $COOLAPK_HTTP_TOKEN" http://127.0.0.1:8000/status

环境变量(远程形态)

变量

默认

说明

COOLAPK_MCP_TRANSPORT

stdio

传输形态:streamable-http(别名 http / streamable_http 等效)启用远程 HTTP 服务;不设或设 stdio 即本地形态

COOLAPK_HTTP_HOST

127.0.0.1

HTTP 监听地址。无论绑哪个地址,未设 COOLAPK_HTTP_TOKEN 都会拒绝启动(见下方「安全」)

COOLAPK_HTTP_PORT

8000

HTTP 监听端口

COOLAPK_HTTP_TOKEN

空

Bearer Token。客户端请求须带 Authorization: Bearer <token>;校验失败返回 401

COOLAPK_ALLOW_ANONYMOUS

空

设 1 允许无 token 启动(回环地址也一样),并让客户端在未登录时按匿名只读发请求(不本地预检拦截、不带 X-App-Token/Cookie)。生产不要开——开了等于 /mcp 完全无鉴权,叠加默认关闭的 DNS rebinding 防护,本机任意网页都能打进来

COOLAPK_ALLOWED_HOSTS

空

逗号分隔的 Host 白名单。设置后开启 FastMCP 的 DNS rebinding 防护并只放行列出的 Host(每项形如 127.0.0.1:8000 或 mcp.example.com);不设则保持关闭以兼容「公网 IP:端口」直连

COOLAPK_ALLOWED_ORIGINS

空

逗号分隔的 Origin 白名单,仅在上面的 Host 白名单启用时生效;不设等价于允许任意来源(非浏览器客户端通常不带 Origin)

uvicorn workers 必须为 1:服务内部以单进程方式启动 uvicorn(uvicorn.Config(...) 未设 workers 参数)。请勿自行用 --workers N 多进程拉起——全局限速(COOLAPK_MIN_INTERVAL)、GET 缓存与验证码负缓存都是进程内状态,多进程互不共享:限速被 worker 数稀释、缓存命中率下降、验证码冷却互不感知,风控风险成倍上升。需要扩容时按「一台服务器一个实例」拆分部署,不要在同一实例上开多进程。

安全

  • 强制 Bearer Token:未设 COOLAPK_HTTP_TOKEN 时服务直接拒绝启动——回环地址也不例外。旧版只对非回环拒绝,而「127.0.0.1 + 反代」正是本文推荐的拓扑,等于公网可达却零鉴权。确实要做无鉴权的内网联调,显式设 COOLAPK_ALLOW_ANONYMOUS=1。token 用随机长串(生成命令见快速启动),不要用可猜的短串。

  • 必须走 TLS:Bearer Token 是明文凭据,裸 HTTP 公网传输会被中间人截获。请勿把 8000 端口直接暴露公网,务必套一层 TLS 反向代理(Nginx 或 Caddy 示例如下),并在防火墙 / 云安全组里关闭直连端口。

  • Host 校验(DNS rebinding 防护)默认关闭,可按需开启:FastMCP 自带的 DNS rebinding 防护按 Host 头白名单拦截请求,远程部署常态的「公网 IP 直连」会被其误判 421 拒绝,因此默认关闭(enable_dns_rebinding_protection=False)。配置 COOLAPK_ALLOWED_HOSTS 后自动开启并只放行列出的 Host——公网部署推荐这样做,配合 Bearer Token 与 TLS 反代形成两层防护。

  • 凭据文件权限:config.json 存有 uid、token 与完整 Cookie,img_secret 是 /img 的签名密钥。POSIX 下目录收紧为 0700、文件 0600(先按 0600 建文件再写,不存在 umask 造成的 0644 窗口);Windows 下没有权限位概念,改用 icacls 去掉继承 ACE、只保留当前用户。收紧失败只记日志,不影响运行。

  • 弱 token 启动自检:COOLAPK_HTTP_TOKEN 少于 16 位、含首尾空白、或仍是示例值 coolapk-mcp-dev 时,启动日志会给出警告(不阻止启动)。这类配置错误本身不报错,只会表现成「客户端莫名 401」。

  • Nginx 反代示例(假设已有 your-domain 的证书配置):

location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_buffering off;   # MCP 流式响应需要关闭缓冲
    proxy_read_timeout 300s;
}
  • Caddy 反代示例(自动申请证书,两行即可):

your-domain {
    reverse_proxy 127.0.0.1:8000
}

systemd 常驻

# /etc/systemd/system/coolapk-mcp.service
[Unit]
Description=Coolapk MCP Server (streamable-http)
After=network-online.target

[Service]
Type=simple
WorkingDirectory=/opt/coolapk-mcp-pro
Environment=COOLAPK_MCP_TRANSPORT=streamable-http
Environment=COOLAPK_HTTP_HOST=127.0.0.1
Environment=COOLAPK_HTTP_PORT=8000
Environment=COOLAPK_HTTP_TOKEN=换成你的随机长串
ExecStart=/opt/coolapk-mcp-pro/.venv/bin/coolapk-mcp
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable --now coolapk-mcp
systemctl status coolapk-mcp        # 确认 active (running)

Docker 部署

仓库根自带 Dockerfile(python:3.14-slim 基础镜像,默认以 streamable-http 形态启动):

docker build -t coolapk-mcp .

docker run -d --name coolapk-mcp \
  -p 127.0.0.1:8000:8000 \
  -e COOLAPK_HTTP_TOKEN=<你的随机长串> \
  -v ~/.coolapk-mcp:/home/coolapk/.coolapk-mcp \
  coolapk-mcp

-e 只需覆盖 COOLAPK_HTTP_TOKEN(传输形态与监听地址已内置默认值);-v 挂载持久化目录后,设备码、登录态与 auth_blob.bin 重启容器不丢。同样建议只映射到 127.0.0.1,交给 TLS 反代对外。

容器以非 root 用户 coolapk(uid 10001)运行,持久化目录是 /home/coolapk/.coolapk-mcp(即上面的挂载点);挂载宿主机目录前先确认宿主机侧对该 uid 可写,例如 sudo chown -R 10001 ~/.coolapk-mcp。

不传 token 容器会「启动即退出」——这是预期的 fail-closed 行为,不是故障:镜像默认监听 0.0.0.0(非回环地址),服务端规定「绑非回环地址必须设置 COOLAPK_HTTP_TOKEN」,缺 token 时进程打印「拒绝启动」提示并以非零码退出(docker logs coolapk-mcp 可见原因)。这是防止登录态裸奔公网的保护逻辑,补上 -e COOLAPK_HTTP_TOKEN=<随机长串> 重新 docker run 即可。

客户端接入(远程形态)

服务端 URL 统一为 https://your-domain/mcp(即反代后的地址加 MCP 端点路径),请求头带 Authorization: Bearer <token>。

dsh

编辑 dsh profile 配置目录下的 cordis.patch.yml:

- id: mcp-coolapk-remote
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: coolapk
    transport: streamable-http
    url: https://your-domain/mcp
    headers:
      Authorization: Bearer <token>
    toolCallTimeoutMs: 120000

Claude Desktop

远程 MCP 建议用官方的 Custom Connector(设置 → Connectors → Add custom connector,填远程 URL),或用 mcp-remote 桥接为 stdio:

{
  "mcpServers": {
    "coolapk-remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-domain/mcp",
               "--header", "Authorization: Bearer <token>"]
    }
  }
}

远程接入的具体设置项以 Claude 官方文档 为准。

Cursor

编辑项目或全局 .cursor/mcp.json,用 url 方式直连远程 MCP:

{
  "mcpServers": {
    "coolapk-remote": {
      "url": "https://your-domain/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

远程字段的最新写法以 Cursor 官方文档 为准。

图片外链(/img 中转)

酷安图床 image.coolapk.com 对非酷安客户端返回 HTTP 567(防盗链),部分聊天类客户端(如手机语音助手)既打不开这个域名,也没有解码 base64 的能力,只能退化成一串链接。

远程模式为此内置了图片中转:设置 COOLAPK_PUBLIC_BASE 后,coolapk_image_link 会把酷安图片地址转成 https://你的域名/img?u=...&exp=...&sig=... 形式的链接,任何能打开网页的客户端都能直接显示图片。/img 默认缩略优先:带尺寸后缀的图先取酷安服务端缩略 .m.jpg(大图省约 40% 流量),缩略不可用时自动回落原图;设 COOLAPK_IMG_THUMBNAIL=0 关闭。

# systemd 里加上对外地址(与 COOLAPK_HTTP_TOKEN 一起生效)
Environment=COOLAPK_PUBLIC_BASE=https://mcp.example.com

设计要点:

  • 签名防滥用:链接带 exp(过期时间戳)与 sig(HMAC-SHA256,密钥取 COOLAPK_IMG_SECRET,未设则随机生成并持久化到 ~/.coolapk-mcp/img_secret,不再复用 COOLAPK_HTTP_TOKEN——避免一次签名泄露连带 Bearer 凭据),任何拿到链接的人都能取图,但改不动参数、也访问不了别的域名——/img 只接受 image.coolapk.com、avatar.coolapk.com、static.coolapk.com 三个域名与 80/443 端口,且在发起任何网络动作之前完成校验,跟随重定向后再复检最终 host。

  • 默认有效期 120 分钟,单次最长 7 天;图片在服务端不做落盘,取到即转发。

  • 只影响图片显示,/img 免 Bearer 鉴权(否则 <img> 标签加载不了),安全边界完全靠签名与域名白名单。

  • 本地 stdio 模式没有对外地址,不生成外链,直接用 coolapk_read_image 返回图片即可。

服务端登录态

远程形态的服务端登录态与本地完全同源,都在服务器的 ~/.coolapk-mcp/:

  • native 模式:~/.coolapk-mcp/config.json 的三键 token(uid / username / token)与设备码(device_code),通过 coolapk login --sms(短信)/ --cookie(Cookie 导入)/ --adb(从已连接的安卓设备提取)建立;

  • auth_blob.bin 签名 blob 仍从酷安安卓 APK 提取:把 APK 改名 coolapk.apk 放到 ~/.coolapk-mcp/ 自动提取,或手动放置已有的 auth_blob.bin;

  • 桌面端 accounts.json 复用(auto 模式)仅在服务器本机装有酷安桌面端时生效,纯服务器环境一般用 native 通道。

具体命令与两步验证流程见上文登录(四通道)一节,blob 获取方式见安装一节的前置说明——两者在服务器上同样适用,不赘述。

⚠️ 风控提示:多端 / 多人共享同一部署时,所有请求都从服务器出口 IP 发出,且共用同一设备码——对酷安侧表现为同一设备高频调用,比单机 stdio 更容易触发风控。好在缓存与全局限速(默认开启,COOLAPK_MIN_INTERVAL / COOLAPK_NO_CACHE 可调)会兜底;如出现 captcha 风控回落,优先降低多端调用频率,详见故障排查。

开发与测试

本地开发装齐工具链(版本与 CI 完全一致):

python -m pip install -e ".[dev]"     # 或 pip install -e . -r requirements-dev.txt(转发到同一份依赖)
ruff check .                          # 静态检查
mypy                                  # 类型检查(配置在 pyproject [tool.mypy])
pytest -q                             # 单元测试
pytest -q --cov=coolapk_mcp --cov-fail-under=60   # 带覆盖率门槛(当前基线 70%,CI 同款)
  • 测试覆盖模型解析、白名单裁剪、限速/分桶/退避、缓存键与单飞、预算截断、HTTP 图片中转、配置与板块映射等;pytest -q 应全绿。

  • tests/manual/regression_probe.py 是零真实网络的离线回归探针(115 项断言),不进 CI,改协议/解析逻辑后可手动跑一遍做冒烟。

  • 覆盖率当前基线约 70%:server.py 82%、client.py 59%,cli.py(57%)与 browser_login.py(47%)仍在低位,属于优先补测区。

  • 测试不依赖本机登录态:conftest.py 默认把 generate_token_v3 打桩成假 token,并把 ~/.coolapk-mcp 下所有导入期路径常量重定向到临时目录,跑测试不会碰真实 config.json / img_secret / auth_blob。

  • CI(.github/workflows/ci.yml)三条腿:Linux 上 Python 3.10 / 3.12 / 3.14 跑 ruff + mypy + pytest(覆盖率门槛 60%)+ coolapk --help + compileall;Windows 上 Python 3.12 跑同一套(覆盖权限与路径分支);另有 Docker 腿做镜像构建与容器内 CLI 冒烟。

  • 结构化日志:设 COOLAPK_LOG_JSON=1 后日志变成一行一条 JSON(stderr),字段 ts/level/logger/msg,异常只保留最后一行;容器采集直接按行解析。

发布流程

  1. 版本三处对齐:pyproject.toml 的 version、coolapk_mcp/__init__.py 的 __version__、CHANGELOG.md 顶部段;

  2. 提交并打带注释 tag:git tag -a vX.Y.Z -m "…",推分支与 tag;

  3. tag 推送后 .github/workflows/release.yml 自动校验三处版本一致 → python -m build 产出 sdist/wheel → 创建/更新 GitHub Release 并附加 dist/*(generate_release_notes 自动生成说明)。

本项目按 git 安装分发,不往 PyPI 发布;generate_release_notes 自动生成的说明是给人看不出所以然的 PR 标题,发布后按 skills/coolapk-mcp-release/SKILL.md 的口语化模板重写一遍(面向普通用户,首行一句话说清这版解决什么麻烦)。

故障排查

登录失效(error_type: auth_expired)

  1. 让 agent 调 coolapk_login_status 或运行 coolapk login --status 确认失效;

  2. 重新登录:桌面端用户重新登录后直接重试即可(服务端会在下次调用时自动重建连接);仍失效则按环境选通道重登——本地桌面推荐 coolapk login --web(全平台、含 Python 3.14 均可用,见登录(四通道));纯服务器环境用 --sms / --cookie / --adb;

  3. stdio 模式下 MCP 服务进程随客户端会话重启,重登后新会话自动带上新登录态。

验证码(error_type: captcha)

含义:对应接口触发了酷安风控(未登录访问动态详情尤其容易触发,见 酷安 API 社区实测文档(Coolapk-API-Collect) 实测记录)。客户端已自动处理:该端点冷却 600 秒内不再重试;coolapk_feed_detail 自动回落到作者动态列表取全文(fetch_source: author_feed_fallback)。人工侧能做的:降低调用频率、稍等再试、完成登录(登录态可显著降低未登录风控概率)。

图片打不开(HTTP 567)

酷安图片 CDN image.coolapk.com 对非官方直连请求返回 HTTP 567(2026-08 实测),把图片 URL 直接丢给浏览器或下载工具大概率拿不到图。请让 agent 使用 coolapk_read_image 工具(带 Referer 下载后以图片形式返回给多模态模型)读取关键截图。如果客户端显示不了 base64 图片(例如手机语音助手),改用远程模式的 coolapk_image_link 生成签名外链,见上文「图片外链(/img 中转)」。

其它

  • parse:多为风控页返回 HTML,按验证码处理思路等待或降低频率;

  • network / transient:客户端已自动退避重试,连续失败再检查本机网络与代理;

  • 搜索结果质量差:保持 strict 默认开启;需要原始结果时显式传 strict=false。

目录结构

(仓库根)
├── pyproject.toml
├── coolapk_mcp/
│   ├── server.py       # MCP 服务与 17 个工具
│   ├── cli.py          # coolapk 命令行(搜索 / 详情 / login 等)
│   ├── client.py       # API 客户端(风控回落、全量评论检索)
│   ├── browser_login.py  # --web 网页登录:系统浏览器 CDP 抓 Cookie(回退 pywebview)
│   ├── config.py       # 登录态持久化(~/.coolapk-mcp)
│   ├── throttle.py     # 限速 / 缓存 / 退避重试
│   ├── postfilter.py   # 搜索过滤、去重、评论关键词检索
│   └── auth/           # token v3 签名与设备码
├── docs/
│   └── PHONE-RIKKAHUB.md  # 手机端(RikkaHub 为例)接入指南
├── AGENT-SETUP.md      # 给 AI agent 的自助接入指南
├── NOTICE.md           # 基座来源声明与本仓改动说明
├── CHANGELOG.md        # 版本变更记录
└── LICENSE             # MIT(承自上游)

agent 侧使用指南(何时用酷安搜资料、话题映射表、风控礼仪)见 skills/coolapk-research/SKILL.md。

参与贡献

众人拾柴火焰高,欢迎大家提 PR 一起完善!无论是新工具、话题映射表补充、风控经验,还是文档纠错,都欢迎。

  1. Fork 本仓并创建特性分支;

  2. 保持纯只读定位——任何写操作(点赞 / 回复 / 关注 / 发帖)的改动不会被接受;

  3. 提交前跑通冒烟:.venv\Scripts\coolapk search "Magisk" 与 python -m coolapk_mcp.server 可正常启动;

  4. 注释与 commit message 用中文,遵循现有代码风格;

  5. 发版(打 tag / 发 release)遵循 skills/coolapk-mcp-release/SKILL.md——含版本一致性检查、四步发布流程与 release 说明模板(说明必须通俗易懂、面向普通用户),tag 和 release 极易漏打,务必走完整流程。

发现酷安接口或风控行为有变化也欢迎开 Issue 反馈实测记录。

许可

MIT(见 LICENSE),基座来源与改动声明见 NOTICE.md。

Available Tools

17 tools
coolapk_app_detailA

查看酷安应用详情(包名 → 应用名、简介、关注数、下载量、版本)。

搜到应用相关动态后,用包名查应用本身:判断「这是不是同一个 App」 「现在的最新版本号」比只看帖子标题可靠。

Args: package_name: 应用包名(如 com.coolapk.market)

Inputs: package_name (required). Returns: result

coolapk_authorA

查看酷安作者的画像与权威度评分(判断「这人是不是该领域大佬」)。

返回基础资料 + author_tier(top/expert/active/normal)、is_expert、 fans_per_feed(精发度)、expertise(从 bio 推断的专长领域)。 搜到高赞帖后先看作者 tier,再决定要不要用 coolapk_author_digest 深挖他的其他帖。

Args: uid: 用户UID

Inputs: uid (required). Returns: result

coolapk_author_digestA

深挖某作者:一次调用拿到他在指定主题下的全部高赞帖(按热度排序)。

适合发现领域大佬(author_tier=top/expert)后,一次性抓出他关于该主题的 完整攻略链(例如「莫离然然」的解锁工具 v1.4→v2.2 全系教程)。 内部按 id 去重(置顶帖会跨页重复),关键词空格分隔多词=任一命中。

Args: uid: 作者UID keyword: 主题关键词(空格分隔多词=任一命中),留空返回全部帖子 pages: 抓取页数 1-5,默认 2(约 40 条) top: 返回条数上限,默认 10,最多 50 keyword_mode: any(默认,任一命中) / all(全部命中,避免「解锁」类泛词召回)

Inputs: uid (required), top, pages, keyword, +1 more. Returns: result

coolapk_boardA

浏览酷安板块(数码、二手、摄影、汽车、好物等 21 个板块)。

板块动态与首页动态是两套入口:想看「数码区最近在聊什么」「二手区的行情」 用这个工具,不要用 coolapk_home。板块 ID 见 boards 映射,常用: digital(数码) phone(手机) computer(电脑) system(系统ROM) sheying(摄影) meihua(美化) car(汽车) waishe(外设) goods(好物) kaixiang(开箱) secondhand(二手) secondhand_apple(二手苹果) hot(热榜) news(快讯) video(视频) wenda(问答) topic(话题) headline(头条) xianliao(闲聊) coolpic(酷图) newphone(新机)。

Args: board: 板块 ID(如 digital)、中文名(如 手机/数码/二手交易)或 page_name(如 V10_DIGITAL_HOME) page: 页码,默认 1

Inputs: board (required), page. Returns: result

coolapk_feed_detailA

获取酷安帖子的完整详情和回复(详情接口被风控时自动回落)。

工具帖找资料建议用 comments_focus=smart:一次拿到「正文 + 楼主补充回复 + 高赞反馈」,获取方式与答疑多在楼主回复里(每个来源最多翻 5 页)。

Args: feed_id: 帖子 ID,也可直接粘贴酷安分享链接或整段分享文案 (如 https://www.coolapk.com/feed/1234567890),自动解析出 ID with_replies: 是否包含回复列表,默认是 reply_page: 回复页码(all_replies / comment_keyword / comments_focus 非 default 时忽略) all_replies: 拉全部一级评论(自动翻页,含内联楼中楼),适合完整舆情/评论分析 comment_keyword: 按关键词检索评论和楼中楼(最多翻 COOLAPK_MAX_REPLY_PAGES 页, 默认 30;空格分隔多词=任一命中;命中条目带 comment_match 字段, 楼中楼按上下文保留,统计见 comment_search;撞上限时 replies_truncated=True) comments_focus: 评论聚焦模式:default(默认时间序一页)/ smart(楼主回复 + 热门评论,各最多 5 页,找工具帖资料首选)/ author(只看楼主回复)/ hot(只看热门评论)/ all(全部一级评论,等同 all_replies)。 楼主回复与热门评论均按页收集(某页不足 10 条即末页,最多 5 页), 是否取全看返回的 focus_meta.truncated / pages_fetched / next_page / budget(两个来源合计的请求数与耗时) with_history: 附带正文修改历史(作者每次编辑的快照,看版本演进) expand_sub_replies: 深度展开楼中楼(对回复数多的父评论补全子回复, 楼主答疑常在楼中楼深处;会额外发请求,只在需要时开)。 有父评论没取全时返回 sub_replies_truncated=True focus_page: 焦点评论起始页(消费上一次的 focus_meta.next_page 用; 只在 comments_focus 为 smart/author/hot 时生效)

Inputs: feed_id (required), focus_page, reply_page, all_replies, +5 more. Returns: result

coolapk_get_urlA

只读透传:GET 任意酷安 /v6/ 只读接口路径并返回裁剪后的 JSON。

仅允许 api.coolapk.com 的 /v6/ 开头路径;含写动作的端点 (点赞/回复/关注/发帖/私信等)一律 403 拒绝。响应保留原始 结构(键名为酷安原始 camelCase),仅剔除 cookie/token 等敏感字段。 适合获取列表页未覆盖的数据(应用详情、板块、二级评论等)。 默认开启严格模式:额外要求末段形态像只读端点 (detail/list/info/space 等),未知写端点会被提前挡住; 设 COOLAPK_GET_URL_STRICT=0 可关闭(透传非常规只读路径时用)。

Args: path: 接口路径或完整 URL,如 /v6/apk/detail?id=com.tencent.mm

Inputs: path (required). Returns: result

coolapk_homeA

获取酷安首页动态(推荐 / 关注 / 热门 / 最新)。

返回 {"tab", "page", "fetched", "has_more", "next_page", "feeds"}:tab 回显 实际分栏(未知取值按 recommend 处理),feeds 为动态列表。

Args: tab: recommend(推荐,/v6/main/indexV8 算法推荐) follow(关注,只看已关注 的人) hot(热门) latest(最新) page: 页码,默认 1

Inputs: tab, page. Returns: result

coolapk_login_statusA

查看当前酷安登录状态(只读,不触发网络请求)。

返回 login_mode(登录模式配置)、is_logged_in(是否已登录)、 uid/username(登录用户)、source(登录态来源 desktop|native|none)、 device_code(设备码是否已配置)。

Inputs: no named parameters. Returns: result

coolapk_notifyA

查看通知(@我的、评论、点赞、关注、私信)。

适合「有人回复我了吗」「私信里说了什么」这类需要个人时间线的场景; 只读,不会标记已读或回复。

Args: ntype: 通知类型,可选 atMeMeFeed(@我的动态) atComment(@我的评论) comment(评论) feedLike(点赞) contactsFollow(关注) message(私信), 默认 message page: 页码,默认 1 with_count: 是否附带各类型未读/总数统计(多一次请求)

Inputs: page, ntype, with_count. Returns: result

coolapk_read_imageA

下载酷安 CDN 图片并作为图片返回(支持一次多张,九宫格帖一次看全)。

仅允许酷安图片域名:image.coolapk.com / avatar.coolapk.com / static.coolapk.com。失败时返回结构化错误,可改用 coolapk_get_url 获取接口数据,或直接向用户呈现 URL。

Args: url: 一个或多个图片 URL,用逗号、空格或换行分隔,最多 9 张 (http 自动升级 https)

Inputs: url (required).

coolapk_secondhandA

二手交易区动态(想了解某机型二手行情、看出售帖时用)。

Args: brand: 品牌 ID,0 表示全部;1005=苹果(其余品牌 ID 可先用 coolapk_search 搜到手机话题后按需试) page: 页码,默认 1

Inputs: page, brand. Returns: result

coolapk_suggestA

获取酷安搜索联想词(查询改写积木)。

输入自然语言或半成品关键词,返回酷安建议的规范搜索词, 可用于把口语化需求改写成酷安搜索习惯用词后再搜。

Args: keyword: 查询词(可以是口语化长句)

Inputs: keyword (required). Returns: result

coolapk_topicA

查看酷安话题详情或话题下的帖子。

Args: tag: 话题标签名 with_feeds: 是否获取话题下的帖子列表 page: 帖子页码 hot_first: 话题帖子按热度排序(点赞+评论*3,默认开); 关闭则保持酷安默认顺序(时间流,多为最新低互动帖)

Inputs: tag (required), page, hot_first, with_feeds. Returns: result

coolapk_user_feedsA

查看酷安用户发布的帖子(支持多页聚合、关键词过滤与热度排序)。

Args: uid: 用户UID page: 起始页码(pages>1 时从该页开始连续抓取) pages: 连续抓取页数 1-5,默认 1;想看某作者的历史干货时设 2-3 keyword: 只保留标题或正文含该词的帖子(空格分隔多词=任一命中) sort: 排序,default(接口原始顺序) / hot(互动热度) / latest(发布时间) keyword_mode: any(默认,任一命中) / all(全部命中,用于精确圈定同一主题)

Inputs: uid (required), page, sort, pages, +2 more. Returns: result

coolapk_user_profileC

查看酷安用户资料。

Args: uid: 用户UID

Inputs: uid (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 17 tools

    Disambiguation3/5

    Most tools are distinct, but several pairs genuinely overlap: coolapk_author vs coolapk_user_profile (both return a user's profile, one adds tier scoring), coolapk_user_feeds with sort=hot/keyword vs coolapk_author_digest (near-identical outcomes), and coolapk_secondhand vs coolapk_board's secondhand/secondhand_apple boards. coolapk_get_url is also a catch-all that can duplicate nearly any read tool. The long descriptions do provide explicit guidance (e.g. 'don't use coolapk_home for boards'), which mitigates but does not remove the ambiguity.

    Naming Consistency4/5

    All 17 tools share the coolapk_ prefix and snake_case, so the namespace is highly predictable. The only deviation is verb style: some are actions (coolapk_search, coolapk_suggest, coolapk_get_url, coolapk_read_image) while others are bare nouns (coolapk_author, coolapk_topic, coolapk_board, coolapk_notify), but each remains readable and unambiguous in form.

    Tool Count4/5

    17 tools is slightly above the ideal band but each maps to a real Coolapk surface (feeds, comments, users, topics, boards, apps, notifications, images). The only borderline additions are coolapk_image_link/coolapk_read_image (two image tools) and the generic coolapk_get_url escape hatch, which could arguably be trimmed or folded in.

    Completeness4/5

    The read/analysis surface is unusually thorough: search + suggest, home/board/secondhand feeds, feed detail with rich comment modes, user feeds, author digest, app detail, notifications, image handling, and a raw /v6/ passthrough for anything uncovered. The notable gap is that the whole server is read-only — no posting, replying, liking or following — which is likely intentional but leaves the write half of the lifecycle uncovered.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      B
      maintenance
      Read-focused MCP server for Zhihu, enabling retrieval of pins, articles, comments, and replies, with optional limited write tools for drafting and editing answers.
      10
      1
      -
    • F
      license
      A
      quality
      D
      maintenance
      A read-only MCP server that enables AI assistants to search files, list directories, retrieve system info, and get file metadata on the local file system.
      4
      -
    • A
      license
      A
      quality
      C
      maintenance
      MCP server that provides AI agents with access to public social media data, including hot lists, searches, content details, user profiles, posts, and comments from platforms like Douyin, Xiaohongshu, Bilibili, and Weibo.
      6
      5 npm
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A local read-only MCP server that lets MCP clients such as the Claude app fetch X/Twitter posts and search, Reddit posts, threads and search, and YouTube transcripts and search. It reads through your own saved logins using a fixed set of read-only commands, and cannot post, vote, follow or message.
      -