关于 EnigmAgent MCP
EnigmAgent 是本地加密凭据库,并支持由操作者批准的 AI Agent 执行操作。它面向需要为 Agent 接入凭据的团队,通过固定操作避免在 Agent 响应中返回密钥值。
主要功能
- 01使用 Argon2id 和 AES-256-GCM 加密凭据库
- 02由操作者定义固定 GET 和 HEAD 操作
- 03向配置的目标附加凭据
- 04经过身份验证的 MCP 和 REST 网关
- 05Python 客户端及框架集成
- 06带版本检查的原子凭据库写入
适用场景
- 01让 Agent 调用获准的 API 操作
- 02使用凭据而不向 Agent 返回其值
- 03将凭据处理接入受支持的 Agent 框架
MCP 相关
MCP 网关默认仅公开凭据库元数据,并支持受限的操作代理。Agent 选择操作者定义的操作,代理附加凭据并返回状态信息,不返回上游响应内容。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
EnigmAgent
本地加密凭据存储,以及由操作员批准的 AI Agent 执行机制。 集成版 3.0.0 包含经过身份验证的保险库、Node 管理工具、 受限的 MCP/REST 网关、Python 客户端和十种原生框架集成。
从这里开始
| 目标 | 入口 |
|---|---|
| 了解已发布和已测试的内容 | 集成版 v3 |
| 下载带版本号的发行包 | GitHub 发行版 |
| 使用原生 Agent 框架 | Python SDK |
| 运行 MCP/REST 网关 | 网关 |
| 无需编写应用代码即可管理保险库 | 管理工具 |
| 运行固定源代码版本的容器 | 容器 |
| 检查安全边界 | 威胁模型和安全策略 |
| 查看较早的源代码版本 | 保留的版本 |
| 查看集成证据 | 原生运行时证据 |
包注册表版本和浏览器商店中的软件包属于不同的发布渠道。 GitHub 源代码变更不会自动更新 npm、PyPI、浏览器扩展或用户已有的安装。请使用带版本号的发行产物及其校验和;安装前请检查注册表中的实际版本。
为什么使用固定操作代理?
返回已解密凭据的工具也会将该凭据交给调用者。仅靠占位符语法无法阻止凭据进入 Agent 的上下文。 因此,EnigmAgent 将其分为两种模式:
- **Agent 模式:**操作员定义固定的 GET/HEAD 操作。Agent 只能选择操作名称。代理会将凭据附加到配置的目标,并且仅返回
{operation, status, ok}。上游响应正文和标头都会被丢弃,包括反射或编码后的凭据。 - **显式可信后端模式:**解析原始凭据需要主动选择启用。此模式与操作代理传输方式不兼容,也不是用于隔离模型的接口。
默认 MCP 模式仅公开元数据。REST 始终需要身份验证。代理允许访问公开的 IPv4 HTTPS 目标。固定的 127.0.0.1 HTTP 目标需要操作员明确启用。不接受重定向、用户选择的 URL/标头以及私有/保留的出站目标。
原生集成
| 框架 | 工厂键 | 已测试的软件包 | 版本 |
|---|---|---|---|
| LangChain | langchain | langchain-core | 1.6.3 |
| LangGraph | langgraph | langgraph | 1.2.11 |
| LlamaIndex | llamaindex | llama-index-core | 0.14.24 |
| CrewAI | crewai | crewai | 1.15.22 |
| Haystack | haystack | haystack-ai | 3.1.1 |
| Microsoft Agent Framework | agent_framework | agent-framework-core | 1.18.0 |
| smolagents | smolagents | smolagents | 1.26.0 |
| Agno | agno | agno | 3.0.10 |
| PydanticAI | pydantic_ai | pydantic-ai-slim | 2.44.0 |
| AutoGen Core | autogen | autogen-core | 0.7.5 |
这些是在本仓库中维护的第三方兼容性集成。 每项集成都使用合成加密保险库和真实的本地身份验证服务执行。测试会检查原生结果、可用的追踪/序列化接口,以及对未知操作的拒绝行为。这些测试并不代表上游认可、合并到上游、模型质量或形式化非干扰性。
LangGraph 包含检查点检查。Haystack 包含带显式可信模块允许列表的序列化管线往返测试。PydanticAI 会执行由本地 FunctionModel 驱动的 Agent 循环;它不会调用付费模型。MCP 互操作性也通过单独安装的官方 Python MCP 客户端进行检查。
经过身份验证的存储
新建的保险库使用 Argon2id 和 AES-256-GCM。保险库格式 v2 会对整个条目集进行身份验证,包括名称、域名和值。信封头会作为关联数据绑定。写入操作会检查修订版本,并在刷新临时文件后原子替换当前文件。写入失败不会更新会话中已提交的内存状态。解锁失败会锁定旧会话。
旧版格式 v1 在显式迁移之前为只读。迁移会验证所有条目密文,并将原文件永久保留为 .v1-backup,同时也会保留滚动备份 .bak。v1 不会对旧版域名元数据进行身份验证;迁移无法通过密码学手段恢复其历史准确性。请检查旧绑定,并独立配置获准的目标位置。
遭入侵的代理进程、管理员或操作系统不在此安全边界内。要运行具有敌意的生成代码,需要使用具有独立权限的代理账户或容器;共享 OS 身份并不构成沙箱。有关备份、回滚、Windows 权限和资源限制方面的说明,请参阅威胁模型。
从源码验证
请使用 Node.js 22 或更高版本。完整的原生集成测试矩阵使用 Python 3.12 进行测试;轻量级客户端要求 Python 3.10 或更高版本。
cd platforms/mcp-server
npm ci --ignore-scripts --no-audit --no-fund
npm test
node tests/verify-package.mjs
集成的 GitHub 工作流还会执行 Python 集成测试、在干净环境中安装构建好的软件包,并启动实际的 Docker 镜像。带标签的发布必须以这些检查全部通过为前提。未配置定期维护任务或大规模联系行为。
历史平台代码
浏览器扩展、PWA、原生 GUI/IDE/移动端封装和较早的集成原型仍作为历史源码保留。它们未经 Node/Python v3 发布测试认证,旧版 v1 浏览器存储也不能与新的 v2 Node 保险库互换使用。其原始文件也保存在完整的版本化源码存档中。平台状态 会区分经过验证的组件与历史内容,而不会把每个目录都宣传为已完成且受支持的产品。
贡献与引用
请参阅 CONTRIBUTING.md、CITATION.cff 和集成计划。贡献必须解决真实的集成需求,并提供可复现的证据。请勿大规模发布问题、索求虚假的互动,也不要再次联系已拒绝提案的维护者。
MIT 许可证。版权所有 2026 Francisco Angulo de Lafuente。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。