TNAB技术设计文件
作者 Aarash Zakeri\ 日期: 05/07/2026\ 状态: 草稿\ 项目: 完全不是Bot MCP
完全不是一个机器人将成为一个MCP,允许代理AI与服务器工作人员一起作为不和谐服务器的智能执行
问题
目标
希望规范人工智能代理与服务器工作人员在服务器中进行协调和交互的方法。其想法是,LLM可以检索和分析消息历史、发送消息、自定义配置文件、分配惩罚或临时惩罚等。还可以授予通过沉默进行临时惩罚的权限。该方法的设计将使人工智能代理能够通过不和谐机器人令牌设置oauth密码来监管多个服务器。因此,进入服务器将使机器人在线登录,然后与服务器建立关联。
非目标
这种方法基于安全标准化,与实际的AI代理无关。设计的方法将实现跨服务器的MOBILITY,允许分析和抓取渠道,以及定制配置文件,以便另一个人可以设置他们的代理,然后决定让他们在服务器中完全自主,或者查询LLM。
AI代理行为独立于MCP项目,因此员工偏好、报告和其他提示/生成处理不在本项目的范围内。
目前,将使项目朝着适度的方向发展,并考虑在所有工具、提示和资源设置完毕后,支持机器人作为正常成员。
提议的解决方案
高级方法
FastMCP服务器将作为API来遵循处理程序->服务。MCP预计将在本地使用,正如目前对它们的期望一样。因此,这将把LLM连接到它需要连接的任何机器人。
这意味着代币已经在本地提供,机器人要么保持与一个机器人的连接,要么在多个机器人之间交换。由于它是本地的,因此不需要保护MCP。
然后,将实现代理在服务器中交互所需的所有相关方法,就像任何人类主持人一样。
因此,用户可以将任何机器人添加到他们的服务器上,将令牌提供给人工智能,然后人工智能可以使用该令牌登录MCP,服务器将验证该令牌是否真正使机器人上线。这里的安全至关重要。
建筑
条目、工具、资源、提示目录将遵循推荐的fastmcp结构。
tnb_mcp_server/
|-- src/
| `-- my_server/
| |-- __init__.py
| |-- server.py
| |-- tools/
| |-- resources/
| |-- prompts/
| |-- config/
| `-- internals/
| `-- services/
|-- tests/
|-- pixi.toml
`-- documentation.mdMCP设计
消息资源
tnb/messages/recent-获取最近的消息(默认值20)\ params:channel_id,限制?自从?之前?
tnb/messages/filter-关键字/结构化搜索(如Discord搜索)\ params:query,user_id?,channel_id?自从?限制?
tnb/messages/pins-获取通道中的所有固定消息
tnb/messages/window-获取消息+周围的消息(用于上下文窗口)\ params:message_id,之前?之后?
tnb/messages/thread-获取消息的回复/线程
tnb/messages/activity-聚合统计数据(消息计数、顶级用户、频率)\ params:channel_id,从什么时候开始?
消息工具
tnb/messages/send-发送短信(可选回复)
tnb/messages/edit-编辑现有消息
tnb/messages/embed-发送嵌入(可选reply_to)
tnb/messages/delete-删除消息
tnb/messages/react-添加反应
tnb/messages/unrespond-删除自己的反应
tnb/messages/bulk_delete-一次删除多条消息\ params:channel_id,message_id?|计数?
渠道资源
tnb/channels/list-获取服务器中的所有频道+描述+id
tnb/channels/by_category-获取某个类别中的频道\ 参数:category_id
tnb/channels/activity-用于检测使用情况的通道活动统计数据
tnb/信道/死区-检测非活动信道\ 参数:阈值_天
渠道工具
tnb/channels/create-创建频道\ params:名称、类型(文本/语音/论坛)、类别id?
tnb/频道/编辑-编辑频道设置
tnb/频道/删除-删除频道
tnb/channels/move-将频道移动到另一个类别
类别资源
tnb/categories/list-获取所有类别及其频道
分类工具
tnb/categories/create-创建类别
tnb/类别/编辑-编辑类别
tnb/categories/delete-删除类别
图像剖面工具
tnb/配置文件/状态-设置状态
tnb/profile/about-关于我
用户资源
tnb/users/id-解析用户id
tnb/用户/配置文件-基本配置文件+角色+加入日期
tnb/users/activity-消息活动统计\ params:从那以后?
tnb/用户/违规行为-过去对用户的审核行为
用户工具
tnb/users/dm-发送直接消息
tnb/users/rename-更改用户昵称
角色资源
tnb/roles/list-获取所有角色+信息
tnb/roles/by_id-按id获取角色详细信息
角色工具
tnb/roles/assign-为用户分配角色
tnb/roles/remove-从用户中删除角色
tnb/roles/create-创建新角色
tnb/roles/delete-删除角色
tnb/roles/bulk_assign-将角色分配给多个用户
执法工具
tnb/强制执行/警告-警告用户(无限制)
tnb/强制/静音-10分钟静音
tnb/强制/静音-具有自定义持续时间的静音
tnb/enforcement/ick-从服务器中删除用户
tnb/执行/禁止-禁止用户
tnb/enforcement/delete_messages-删除消息(目标或批量)
tnb/enforcement/rename-强制更改昵称
tnb/enforcement/move_voice-在语音通道之间移动用户
tnb/enforcement/disconnect_voice-断开用户与vc的连接
适度(决策层)
旨在结合步骤
tnb/审核/评估-分析邮件中的垃圾邮件、毒性、滥用\ params:message_id |文本\ 返回:spam_score、toxity_score、flags、recommended_action
tnb/moderation/auto_enforce-调用evaluate^^+一步完成各个动作,有点像操作系统中的ISR->制定惩罚建议系统 params:message_id | user_id,策略?\ 返回:action_taken,推理
消息简化(决策层)
tnb/messages/summary-在窗口中总结消息\ params:channel_id,从什么时候开始?|限制?
tnb/messages/semantic_search-基于嵌入的搜索(非关键字)\ params:query,channel_id?限制?
用户跟踪(决策层)
tnb/用户/风险-根据过去的违规行为和注意事项评估用户风险\ 参数:user_id\ 返回:risk_score,原因
tnb/users/summary-总结用户行为\ params:user_id,从什么时候开始?
渠道概述
tnb/渠道/总结-总结渠道的用途\ params:channel_id,从什么时候开始?
tnb/渠道/建议-建议行动(存档、重组等)\ params:channel_id?
常规服务器资源
tnb/server/emojis-获取所有表情符号
tnb/server/info-基本服务器元数据
tnb/服务器/邀请-活动邀请链接
阻塞器
用户应该在哪里查看日志?\ 1-1,其中LLM控制一个机器人;或1-many,其中它控制多个机器人。因此,实例化机器人并将其存储在内存或其他东西中。
TODO:计划事件,频道覆盖\ 我应该添加哪些提示?\ 跨层位图工具和资源
是否为跨会话的内存添加本地向量数据库?这是代理人的责任吗?
三层权限,其中1代表用户,2代表支持角色,3代表管理员
测试计划
如果给5个LLM,他们都应该表现得一样。如果他们不这样做,那么界面就不好
