Hermes에서 MCP 사용
기준일: 2026-07-26
난이도: 중급
공식 기준: Use MCP with Hermes
개요
MCP 서버 연결, 도구 필터링, 안전 실무 패턴을 단계별로 정리합니다.
핵심 개념
| 개념 | 설명 |
|---|---|
| least privilege | 최소 도구 표면 |
| include/exclude | 필터 |
| utility wrappers | resources/prompts |
| reload | 설정 재적용 |
상세
MCP를 언제 쓰나
원문 절: When should you use MCP?
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
멘탈 모델
원문 절: Mental model
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
1단계: MCP 지원 설치
원문 절: Step 1: install MCP support
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
cd ~/.hermes/hermes-agent
uv pip install -e ".[mcp]"
2단계: 서버 하나부터
원문 절: Step 2: add one server first
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
mcp_servers:
project_fs:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/my-project"]
3단계: 로드 검증
원문 절: Step 3: verify MCP loaded
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
Tell me which MCP-backed tools are available right now.
4단계: 즉시 필터링
원문 절: Step 4: start filtering immediately
- Example: whitelist only what you want — 공식 하위 절. 구현·설정 세부 원문 참조.
mcp_servers:
github:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: "***"
tools:
include: [list_issues, create_issue, search_code]
WSL2: bridge Hermes in WSL to Windows Chrome
- Why this mode is useful — 공식 하위 절. 구현·설정 세부 원문 참조.
- Recommended server — 공식 하위 절. 구현·설정 세부 원문 참조.
- Typical prompt — 공식 하위 절. 구현·설정 세부 원문 참조.
- When
/browser connectis the wrong tool — 공식 하위 절. 구현·설정 세부 원문 참조. - Known pitfalls — 공식 하위 절. 구현·설정 세부 원문 참조.
- Example: blacklist dangerous actions — 공식 하위 절. 구현·설정 세부 원문 참조.
Hermes (WSL) -> MCP stdio bridge -> Windows Chrome
필터가 실제로 영향을 주는 것
원문 절: What does filtering actually affect?
- Utility wrappers you may see — 공식 하위 절. 구현·설정 세부 원문 참조.
- Server-native MCP tools
- Hermes-added utility wrappers
공통 패턴
원문 절: Common patterns
- Pattern 1: local project assistant — 공식 하위 절. 구현·설정 세부 원문 참조.
- Pattern 2: repo-native work record with Open Scaffold — 공식 하위 절. 구현·설정 세부 원문 참조.
- Pattern 3: GitHub triage assistant — 공식 하위 절. 구현·설정 세부 원문 참조.
- Pattern 4: internal API assistant — 공식 하위 절. 구현·설정 세부 원문 참조.
- Pattern 4: documentation / knowledge servers — 공식 하위 절. 구현·설정 세부 원문 참조.
mcp_servers:
fs:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/project"]
git:
command: "uvx"
args: ["mcp-server-git", "--repository", "/home/user/project"]
튜토리얼: 필터 포함 E2E 설정
원문 절: Tutorial: end-to-end setup with filtering
- Phase 1: add GitHub MCP with a tight whitelist — 공식 하위 절. 구현·설정 세부 원문 참조.
- Phase 2: expand only when needed — 공식 하위 절. 구현·설정 세부 원문 참조.
- Phase 3: add a second server with different policy — 공식 하위 절. 구현·설정 세부 원문 참조.
mcp_servers:
github:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: "***"
tools:
include: [list_issues, create_issue, search_code]
prompts: false
resources: false
Safe usage recommendations
- Prefer allowlists for dangerous systems — 공식 하위 절. 구현·설정 세부 원문 참조.
- Disable unused utilities — 공식 하위 절. 구현·설정 세부 원문 참조.
- Keep servers scoped narrowly — 공식 하위 절. 구현·설정 세부 원문 참조.
- Reload after config changes — 공식 하위 절. 구현·설정 세부 원문 참조.
tools:
resources: false
prompts: false
Troubleshooting by symptom
- "The server connects but the tools I expected are missing" — 공식 하위 절. 구현·설정 세부 원문 참조.
- "The server is configured but nothing loads" — 공식 하위 절. 구현·설정 세부 원문 참조.
- "Why do I see fewer tools than the MCP server advertises?" — 공식 하위 절. 구현·설정 세부 원문 참조.
- "How do I remove an MCP server without deleting the config?" — 공식 하위 절. 구현·설정 세부 원문 참조.
enabled: false
Recommended first MCP setups
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
Related docs
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
체크리스트
- 공식 원문 Use MCP with Hermes과 대조했다
- 관련 코드·설정·권한을 로컬에서 확인했다
- 보안·opt-in·allowlist 정책을 지켰다
- 스모크 테스트 또는 단계 검증을 수행했다
다음 단계
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스