是什么
pmm8-mcp 是一个远程 MCP server,通过 https://www.hipmm8.com/mcp 暴露 6 个 PMM-8+ 工具.任何支持 MCP 协议的客户端都能接入 — 拿你的 hipmm_sk_* 当 Bearer token 即可.
所有调用按用户聚合计量 (跟 SDK API 用量同一套账户体系), 一个用户的多把 key 数据合在一起,无需关心用哪一把.
MCP = Model Context Protocol
6 个 Tool 概览
| Tool | 用途 | 什么时候调用 |
|---|---|---|
| pmm8_get_encoding_guide | 8 维 × 5 段位编码规范 + 常见错误 + 范例 | 生成任何编码前必读 |
| pmm8_assess_persona ⭐ | 8 维段位 + 证据 → 校准编码 + 完整画像 | 为名人/公众人物建编码 |
| pmm8_lookup_persona | 查持久化人物库 (跨会话/跨客户端一致) | 每次评估前先查 |
| pmm8_analyze_personality_code | 解析已有编码 → 八维画像 + 行为提示 | 手上已有编码做解读 |
| pmm8_build_ai_legion | 指挥官编码 + 场景 → 互补 AI 军团 | 组团队 / 角色匹配 |
| pmm8_mirror_persona | 编码 → 可灌入 LLM 的 system prompt | 让 LLM 扮演某个画像 |
拿 token
访问 /dashboard → 点 创建新 Key → 复制一次性显示的 hipmm_sk_xxx.
一个用户最多 5 把活跃 key,任意一把都能用,**调用全部计入同一账户**.下面所有示例的 <你的 token> 都填这一把.
只显示一次
接入示例 · 通用 HTTP MCP
大多数 MCP 客户端支持 HTTP transport, 用统一 JSON 配置:
MCP client config · 通用
{
"mcpServers": {
"pmm8": {
"type": "http",
"url": "https://www.hipmm8.com/mcp",
"headers": {
"Authorization": "Bearer <你的 token>"
}
}
}
}接入示例 · Claude Code (CLI)
bash
# 装新的 (远程 + 鉴权) claude mcp add --transport http --scope user pmm8 https://www.hipmm8.com/mcp \ --header "Authorization: Bearer <你的 token>" # 检查 claude mcp list
重启客户端后,在对话里输入 /mcp 应显示 pmm8 ✔ connected 和 6 个 tool.
接入示例 · Codex CLI
编辑 ~/.codex/config.toml:
toml · ~/.codex/config.toml
[mcp_servers.pmm8] type = "http" url = "https://www.hipmm8.com/mcp" [mcp_servers.pmm8.headers] Authorization = "Bearer <你的 token>"
若 Codex 版本不支持 http transport,改用 stdio + mcp-remote 桥接:
toml · 兼容旧版
[mcp_servers.pmm8] command = "npx" args = ["-y", "mcp-remote", "https://www.hipmm8.com/mcp", "--header", "Authorization:Bearer <你的 token>"]
接入示例 · IDE 编辑器扩展 (Cursor / Cline / Continue 等)
所有走 MCP 协议的 IDE 扩展都用统一 JSON 配置 (跟 #04 一致):
JSON · 任意支持 MCP 的客户端
{
"mcpServers": {
"pmm8": {
"type": "http",
"url": "https://www.hipmm8.com/mcp",
"headers": { "Authorization": "Bearer <你的 token>" }
}
}
}自然语言调用示例
配置好之后,直接在你的客户端里用自然语言提:
对话示例
用 pmm8 解析 O(I)CLB|X-ID-PR(AR)-SE-LT 这个编码 用 pmm8 给段永平生成镜像, 要先读编码指南、走标准评估流程 用 pmm8 给我 (编码 I(22)A(78)L(18)X(82)-ID(20)-AR(PR)(68)-SE(78)-LT(75)) 组一支做 SaaS MVP 的军团
客户端会自动识别需要调用哪个 tool, 串联多个 tool 完成任务.
查看你的 MCP 用量
每次调用 (无论从哪个 MCP 客户端、哪一把 key) 都会按你的账户分桶计量.两个地方可看:
控制台首页
/dashboard
「§ PMM-8 MCP」section — 本月调用总数 / 错误数 / 活跃 tool / 按 tool 横条 / 最近 10 条
完整后台
/user
KPI + 14 天趋势 + 按 tool 分布 + 持久化人物库 + 最近 200 条 (含参数 / IP / 错误)
从控制台点 查看详情 ↗ 跳转到 /user,自动以你的登录态进入,零额外输入.
安全与计量
- token 即用户身份:任意一把 hipmm_sk_* 都映射到你的账户,调用合并计量
- token 泄漏自救:dashboard → 撤销那把 key (revoke), 其它 key 不受影响
- 计量周期:Redis hash 按月分桶,过期 32 天自动清,跨月用量自然分开
- per-call 数据:每次调用记录 timestamp / tool name / 耗时 / 客户端 IP / 参数摘要 (≤ 80 字) / 错误 (如果有), 保留最近 200 条
- 持久化人物库:assess_persona 生成的编码全站共享 (同一名字所有用户拿到相同结果, 保证一致性), 不计入个人配额
常见问题
Q: 我用 Claude Code / Cursor / Codex 调 pmm8 时,LLM 调用是计哪边的额度?
A: pmm8-mcp 本身不烧 LLM token, 是纯本地计算 (编码解析、画像生成都是算法/规则). 只有调用方客户端用的 LLM (你的 IDE 自己配置的) 烧 token, 那部分跟 HiPMM 无关.
Q: 多人共用一个 token 行吗?
A: 技术上能跑通, 但数据会混在一个账户里看不清谁调的. 推荐每人创建自己的 key.
Q: 同一个名字两次 assess 拿到的编码会一样吗?
A: 一样. lookup_persona 命中即直接返回,assess 加 overwrite=true 强制重算.这是为了跨会话/跨客户端的一致性保障.
Q: 自建一个独立 pmm8-mcp 实例?
A: 源码在 HiPMM 仓库 pmm8-mcp/ 子目录, 含 Dockerfile 和 docker-compose override. 自建后请用本地 token (跟我们的远程 token 体系不互通).