项目简介

这个项目是一个基于Model Context Protocol (MCP) 的服务器，它充当AI智能体（如支持MCP的LLM客户端）与本地安装的 Authenticator App · 2FA 应用之间的桥梁。它允许AI智能体通过安全的方式访问存储在 Authenticator App 中的双重认证（2FA）代码和密码，从而协助完成网站的自动化登录等操作。

主要功能点

获取双重认证码： 允许AI智能体检索特定网站和用户的当前有效的双重认证（2FA）代码及其剩余有效时间。
获取密码： 允许AI智能体检索特定网站和用户的存储密码。
查询可用账户： 允许AI智能体查询某个网站下，Authenticator App 中存储的所有关联账户列表。

安装步骤

首先，您需要在您的计算机上安装并运行配套的桌面应用 'Authenticator App · 2FA'。您可以从 Microsoft Store、Mac App Store 或通过 Ubuntu/Debian .deb包安装它。
启动 'Authenticator App · 2FA' 应用。
在应用的设置中找到 "MCP Server" 部分，启用 MCP 服务器功能并生成一个访问令牌（Access Token）。请务必立即复制此令牌，因为它只会显示一次。
本 MCP 服务器通常通过 npm 包发布。最简单的方式是直接使用 'npx' 命令运行它，这会自动下载并执行最新的版本。

服务器配置

本 MCP 服务器需要配置在您的 MCP 客户端（例如支持 MCP 的 AI 开发环境或 LLM 客户端）的配置文件中，以便客户端能够启动并连接到它。典型的配置会指定服务器的名称、启动命令及其所需参数。

您需要在客户端的配置中指定启动本服务器的命令和传递访问令牌：

服务器的名称，例如：'Authenticator App MCP'
服务器的启动命令 ('command')，例如：在 macOS/Linux 上是 'npx'，在 Windows 上可能是 'cmd'
传递给命令的参数列表 ('args')。您需要在此处包含 'authenticator-mcp' 以及通过 '--access-token=您的访问令牌' 参数或设置 'AUTHENTICATOR_ACCESS_TOKEN' 环境变量来提供之前生成的访问令牌。

请查阅您的 MCP 客户端的文档以获取具体的 MCP 服务器配置方法。

基本使用方法

在您的 MCP 客户端（如支持 MCP 的 AI 聊天界面或开发环境）中配置并连接本 Authenticator App MCP 服务器后，AI 智能体将能够感知到服务器提供的工具能力。

您可以通过与 AI 智能体进行自然的语言对话来请求获取双重认证码或密码。例如，您可以说：“请帮我获取 GitHub 账户 '[email protected]' 的双重认证码” 或 “我需要登录 example.com，我的用户名是 'user1'，请提供密码”。

如果 AI 智能体被设计为使用 MCP 工具，它将识别您的意图，并通过 MCP 协议调用本服务器提供的相应工具（'get_2fa_code' 或 'get_password' 等）。服务器将通过 Authenticator App 获取信息并返回给 AI 智能体，AI 智能体随后可以将结果呈现给您或用于执行自动化登录任务。

关键词

信息