docs: add comprehensive MCP documentation and examples

- docs/mcp.md: Full MCP documentation covering prerequisites, configuration,
  transports (stdio + HTTP), security (env filtering, credential stripping),
  reconnection, troubleshooting, popular servers, and advanced usage
- README.md: Add MCP section with quick config example and install instructions
- cli-config.yaml.example: Add commented mcp_servers section with examples
  for stdio, HTTP, and authenticated server configs
- docs/tools.md: Add MCP to Tool Categories table and MCP Tools section
- skills/mcp/native-mcp/SKILL.md: Create native MCP client skill with
  full configuration reference, transport types, security, troubleshooting
- skills/mcp/DESCRIPTION.md: Update category description to cover both
  native MCP client and mcporter bridge approaches
This commit is contained in:
teknium1 2026-03-02 18:52:33 -08:00
parent 64ff8f065b
commit 63f5e14c69
6 changed files with 928 additions and 1 deletions

View file

@ -496,6 +496,23 @@ hermes tools
**Available toolsets:** `web`, `terminal`, `file`, `browser`, `vision`, `image_gen`, `moa`, `skills`, `tts`, `todo`, `memory`, `session_search`, `cronjob`, `code_execution`, `delegation`, `clarify`, and more.
### 🔌 MCP (Model Context Protocol)
Connect to any MCP-compatible server to extend Hermes with external tools. Just add servers to your config:
```yaml
mcp_servers:
time:
command: uvx
args: ["mcp-server-time"]
notion:
url: https://mcp.notion.com/mcp
```
Supports stdio and HTTP transports, auto-reconnection, and env var filtering. See [docs/mcp.md](docs/mcp.md) for details.
Install MCP support: `pip install hermes-agent[mcp]`
### 🖥️ Terminal & Process Management
The terminal tool can execute commands in different environments, with full background process management via the `process` tool: