HermesAgent集成MCP服务器：Filesystem与Postgres插件配置详解

一、配置 Filesystem MCP 服务器

想让你的 Hermes Agent 拥有安全读写本地文件的能力吗？Filesystem MCP 服务器正是为此而生。它本质上是一个运行在 Node.js 环境下的本地文件协议服务，其核心设计理念是“画地为牢”——将访问权限严格限定在你指定的根目录下，从而有效防止越界访问，保障系统安全。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

配置过程并不复杂。首先，打开 Hermes 的主配置文件：~/.hermes/config.yaml。

接着，在 mcp_servers 这个配置区域下，新增一个名为 filesystem 的条目。这里的关键在于正确填写 command 和 args 参数：command 固定指向 npx，而 args 则需要包含服务器包路径和你授权的目录，例如 ["@modelcontextprotocol/server-filesystem", "/home/user/projects"]。切记，将示例路径替换成你实际希望开放访问的项目目录。

配置保存后，别忘了在终端执行一次 hermes doctor 命令。这个命令就像一次健康检查，它能验证你的配置是否被系统正确识别为有效的 MCP 服务器。

二、配置 Postgres MCP 服务器

如果说 Filesystem 服务器打通了本地文件的任督二脉，那么 Postgres MCP 服务器就是连接数据库世界的桥梁。通过它，Hermes Agent 可以执行 SQL 查询、洞察表结构，甚至进行数据插入等操作。当然，这一切的前提是你得有一个正在运行且可访问的 PostgreSQL 数据库实例。

配置的第一步是确保你的 PostgreSQL 服务状态正常，并且能够从本地连接（通常默认监听在 localhost:5432）。

接下来，准备一个标准格式的连接字符串 DATABASE_URL。这个字符串包含了协议、用户名、密码、主机、端口和数据库名等所有必要信息，格式类似这样：postgresql://hermes_user:hermes_pass@localhost:5432/hermes_db。

然后，再次编辑 ~/.hermes/config.yaml 文件。在 mcp_servers 区域下，新增一个 postgres 条目。其中，command 同样设为 npx，args 设为 ["@modelcontextprotocol/server-postgres"]。最关键的一步是在 env 环境变量部分，填入刚才准备好的 DATABASE_URL。

还有一点需要特别注意：请确保你在 DATABASE_URL 中指定的数据库用户，至少拥有 SELECT 查询以及你计划使用的 DML（数据操作语言）权限。Hermes 不会自动创建数据库模式（schema）或表，这些都需要你事先准备好。

三、启用并验证 MCP 工具集

配置好了服务器，是不是工具就能直接用了？别急，还需要最后一步“激活”。MCP 服务器配置完成后，其对应的工具集并不会自动加载，你需要显式地声明或通过命令触发，Hermes 才会将它们纳入可用范围。系统会根据服务器名称自动为工具添加前缀，例如，来自 filesystem 服务器的工具都会以 mcp-filesystem- 开头。

如何验证呢？启动你的 Hermes CLI 会话，输入命令 /tools。这个命令会列出当前所有已加载的工具。

在输出的列表中仔细查找，如果配置成功，你应该能看到类似 mcp-filesystem-read_file 或 mcp-postgres-query 这样的条目。

万一没有找到，可以尝试重启 Hermes 进程。或者，更直接的方法是使用 hermes chat --toolsets "mcp-filesystem,mcp-postgres" 这样的命令，强制加载指定的工具集。

四、限制工具权限以保障安全

能力越大，责任越大。Filesystem 和 Postgres 服务器提供的工具非常强大，但正因如此，也伴随着潜在风险（例如误删文件、执行 DROP TABLE 等危险操作）。因此，遵循“最小权限原则”，主动限制可用工具的范围，是保障系统安全的最佳实践。

这可以通过配置文件中的 allowed_tools（允许列表）或 blocked_tools（阻止列表）来实现。

你可以在 config.yaml 文件里对应服务器的配置块中，添加一个 allowed_tools 列表，只填入你明确需要的工具名，例如 ["filesystem_list_directory", "filesystem_read_file"]。这样，Agent 就只能使用列表内的工具。

反过来，如果你只是想禁用某些高危操作，可以使用 blocked_tools 列表，明确列出要禁止的工具，比如 ["filesystem_write_file", "filesystem_delete_file"]。

权限规则修改并保存后，再次运行 hermes doctor 是个好习惯，它能帮你确认新的工具过滤规则是否已经生效。