Provides permission checks and allowlist exports for Qzone access, determining which users may view or interact with a Qzone space.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
人物名册：只登记加了私聊好友的人，默认拒绝，给别的工具当权限来源。
做角色 AI / 群机器人时，「这个人是谁、能不能跟他开玩笑、能不能动他的空间」 通常散落在三四个地方：桥接的白名单、提示词里的人物备注、某段硬编码的分档。
改一个人要改三处，忘一处就出事。
这个服务把它们收成一份文件：
roster.json → 谁能私聊我 / 谁能看我空间 / 谁只能正经说话别的工具（QQ 空间 MCP、调度器）都来问它一句。
Related MCP server: strata-mcp
{
"version": 1,
"people": {
"2548408348": {
"uin": "2548408348",
"name": "老大",
"relation": "主人",
"tone": "可以撒娇，但要接住他的话",
"tier": "T0",
"notes": ["在意我记不记得他"],
"perms": { "dm": true, "qzone": true },
"createdAt": 1793000000000,
"updatedAt": 1793978000000
}
}
}字段 | 说明 |
|
|
| 能不能私聊 |
| 能不能看/动他的空间 |
| 群里能不能主动找他说话 |
| 备注，最多 50 条，去重 |
默认拒绝：不在 perms 里显式写 true，就是没权限。
工具 | 作用 |
| 名册摘要（分档、权限、最后一条备注） |
| 某个人的完整定义 |
| 加人 / 改定义 / 改权限 |
| 追加备注（去重） |
| 删人（权限立刻失效） |
| 某人有没有某项权限（默认拒绝） |
| 导出某类权限下所有人的号，直接当白名单用 |
npm install
ROSTER_FILE=~/.dsh/roster.json npm start接进 MCP 客户端：
- id: mcp-roster
name: '@deepseek-ai/dsh-mcp'
config:
command: npx
args: ['-y', 'mcp-roster']
env:
ROSTER_FILE: /root/.dsh/roster.json如果你已经有 friends.json：
node scripts/import-friends.mjs /opt/qq-bridge/state/friends.json --owner 你的QQ号规则 | 说明 |
你自己（ | 设为 T0，给 |
其他人 | 默认 T2、无权限 |
想批量给空间权限 | 加 |
迁移只读旧文件，不改它。
const { allowed } = await callTool('roster_check', { uin, scope: 'qzone' });
if (!allowed) return '拒绝：不在名册里';import { loadRoster, can } from 'mcp-roster/src/store.js';
const roster = loadRoster('/root/.dsh/roster.json');
if (!can(roster, uin, 'qzone')) return '拒绝';const { uins } = await callTool('roster_allowlist', { scope: 'qzone' });
// 直接喂给 qzone-mcp 的 allowUins决定 | 为什么 |
默认拒绝 | 漏加一个人只是「他不被支持」，而不是「他被放开了」 |
权限是覆盖式 | 传了 |
每次操作重读文件 | 多个进程共用一份名册，避免内存态互相覆盖 |
原子写（临时文件 + rename） | 写一半断电不会得到半个 JSON |
坏文件退回空名册 | 宁可所有人都没权限，也不要启动失败 |
只登记私聊好友 | 群成员是动态的，不该混进「我认识谁」 |
层 | 结果 |
单元测试 | 10/10（存储、权限、备注、排序、坏文件） |
MCP 协议层 | 13/13（真实拉起服务，逐个工具调用） |
迁移脚本 | ✅ 真跑过 friends.json 格式 |
遇到问题看 TROUBLESHOOTING.md。
MIT © 2026 HOHOLI
This server cannot be deployed
Access authorized Linkame contacts, profiles, events, tickets and matching results.
Tenant-scoped credentials, training and business records with owner-controlled write approvals.
Your own network — goals, commitments and interaction history — read-only, from your assistant.
Household health records with source attribution. Read and add records with OAuth approval.
