Plex MCP帐户查找器
模型上下文协议服务器,连接到多个Plex帐户,聚合服务器用户访问,并公开用于模糊用户查找和登录令牌生成的工具。基于官方Plex API构建,使用 smithery TypeScript运行时。
特性
- 在每个配置的帐户令牌中发现Plex媒体服务器。
- 通过电子邮件、用户名或显示名称在所有服务器上模糊搜索用户。
- 验证帐户连接,并列出拥有/共享的服务器
plex_status. - 生成Plex身份验证URL(基于PIN),并通过MCP工具轮询它们以捕获新令牌。
- 可配置缓存,以避免在运行重复查询时冲击Plex端点。
配置
smithery.yaml 已经指向 src/index.ts。提供匹配的配置对象 configSchema:
{
"log_level": "info",
"cache_ttl_seconds": 300,
"accounts": [
{ "label": "primary", "token": "
" },
{ "label": "secondary", "token": "
" }
]
}log_level:debug,info,warn,或error(默认值:info).cache_ttl_seconds:服务器/用户查找的缓存持续时间(30-3600秒,默认300秒)。accounts:Plex账户API代币列表以及可选的客户端标识符。每个令牌都应该是从Plex Web或pin流中检索到的帐户级令牌。
工具
plex_status–总结帐户有效性、服务器和可选的用户计数。plex_lookup_user–所有服务器用户的模糊查询(query,可选max_results,refresh).plex_generate_auth_url–生成基于PIN的登录URL(client_identifier可选)用于生成新令牌。plex_check_auth_pin–轮询以前发布的PIN(pin_id,client_identifier)并报告身份验证令牌是否就绪。
发展
npm install
npm run dev # runs smithery dev with hot reload类型检查和构建:
npm run typecheck
npm run build:stdio
npm run build:shttp生成的捆绑包存储在 .smithery/ 并且可以直接部署到Smithery。
备注
- 日志记录是结构化的JSON;敏感值(标记)会自动编辑。
- 管理器为配置的TTL缓存服务器和用户快照。使用
refresh: true在需要时绕过缓存。 - Plex PIN URL很快过期;投票与
plex_check_auth_pin直到authToken填充后,存储该令牌以供将来使用。
