NAS를 AI 어시스턴트에 연결하는 일반적인 방법은 작업 하나당 MCP 도구 하나를 등록하는 것입니다. TrueNAS SCALE을 제대로 지원하려면 50~80개의 도구 스키마가 필요합니다. 이는 요청마다 모델이 질문을 한 글자도 읽기 전에 컨텍스트 창의 약 28,000토큰을 소모한다는 뜻입니다. 스토리지를 건드리지 않더라도 말이죠.
truenas-mcp는 TrueNAS SCALE REST API 전체인 18개 카테고리의 278개 작업을 약 200토큰만 사용하는 단일 계층형 도구 하나로 처리합니다. 모델은 어떤 카테고리가 있는지 물어보고, 필요한 카테고리를 드릴다운한 다음, 작업을 호출합니다. 파괴적인 작업은 confirm: true 없이는 실행을 거부합니다.
# No install needed
TRUENAS_URL=https://truenas.local TRUENAS_API_KEY=1-abc123 npx truenas-mcpClaude Code:
claude mcp add truenas -- npx -y truenas-mcp --env TRUENAS_URL=https://truenas.local --env TRUENAS_API_KEY=1-your-api-key-hereAPI 키는 TrueNAS UI에서 가져옵니다: 설정 > API 키 > 추가.
Related MCP server: Proxmox MCP Server
사용자: "제 풀이 정상인지 확인해 주시고, 미디어 데이터셋용 NFS 공유를 만들어 주시겠어요?"
→ truenas({ category: "storage", action: "pool_list" })
tank — ONLINE, 68% used, 0 errors
→ truenas({ category: "sharing", action: "nfs_share_create",
params: { path: "/mnt/tank/media", comment: "Media share" } })모델은 먼저 truenas({ category: "sharing" })를 호출하여 nfs_share_create를 발견했습니다. 36개의 공유 작업이 프롬프트에 포함될 필요가 없었습니다.
truenas-mcp | 일반적인 NAS MCP 서버 | |
작업 수 | 278 | 5-80 |
토큰 사용량 | ~200토큰 (도구 1개) | 5,000-30,000토큰 (도구 50-80개) |
탐색 방식 | 계층형 — 필요한 것만 요청 | 평면형 — 모든 것이 처음에 로드됨 |
MCP 리소스 | 읽기 전용 대시보드 12개 | 0 |
설치 |
| 소스에서 빌드 / pip |
안전성 | 파괴적 작업은 | 다양함 |
# Using npx (no install needed)
TRUENAS_URL=https://truenas.local TRUENAS_API_KEY=1-abc123 npx truenas-mcp
# Or install globally
npm install -g truenas-mcp변수 | 필수 | 설명 |
| 예 | TrueNAS 인스턴스 URL (예: |
| 예 | TrueNAS UI에서 가져온 API 키: 설정 > API 키 > 추가 |
| 아니요 | SSL 검증을 건너뛰려면 |
claude_desktop_config.json에 추가하세요:
{
"mcpServers": {
"truenas": {
"command": "npx",
"args": ["-y", "truenas-mcp"],
"env": {
"TRUENAS_URL": "https://truenas.local",
"TRUENAS_API_KEY": "1-your-api-key-here",
"TRUENAS_VERIFY_SSL": "false"
}
}
}
}claude mcp add truenas -- npx -y truenas-mcp \
--env TRUENAS_URL=https://truenas.local \
--env TRUENAS_API_KEY=1-your-api-key-here \
--env TRUENAS_VERIFY_SSL=false278개의 개별 도구를 등록하는 대신(LLM 시스템 프롬프트에서 ~30k 토큰을 소모하게 됨), 이 서버는 truenas라는 하나의 도구를 세 가지 사용 모드로 노출합니다:
truenas()설명과 작업 수가 포함된 18개 카테고리 전체를 반환합니다 (~200토큰).
truenas({ category: "storage" })해당 카테고리의 모든 작업과 필수/선택 매개변수를 반환합니다.
truenas({ category: "storage", action: "pool_list" })
truenas({ category: "storage", action: "dataset_create", params: { name: "tank/media", compression: "LZ4" } })즉, LLM은 실제로 사용하는 것에 대해서만 토큰 비용을 지불합니다.
카테고리 | 작업 수 | 포함 내용 |
| 24 | 시스템 정보, 구성, 서비스, 메일, API 키, NTP |
| 32 | 풀, 데이터셋, 스냅샷, 주기적 스냅샷 작업 |
| 36 | SMB/CIFS, NFS 내보내기, iSCSI 대상/익스텐트/포털/이니시에이터 |
| 15 | 인터페이스, 전역 구성, 정적 라우트, IPMI, 스테이징 변경 |
| 16 | 사용자, 그룹, 권한/역할 |
| 7 | 물리 디스크, SMART 테스트, 온도 |
| 16 | 가상 머신, VM 장치 (디스크, NIC, 디스플레이, PCI) |
| 17 | Docker 앱, 컨테이너 런타임 구성 |
| 14 | 시스템 업데이트, 부트 환경, 부트 풀 |
| 8 | TLS 인증서, ACME/Let's Encrypt, DNS 인증자 |
| 10 | 알림, 알림 서비스 (Slack, 이메일, PagerDuty) |
| 49 | 복제, 클라우드 동기화, 클라우드 백업, cron, rsync, 초기화 스크립트, SSH 키 |
| 7 | stat, listdir, mkdir, 권한, ACL, chown |
| 3 | 메트릭 구성, 그래프, 시계열 데이터 |
| 8 | Active Directory, LDAP, Kerberos |
| 12 | SSH, FTP, SNMP, UPS, 시스템 튜너블 |
| 3 | 감사 로그, 감사 구성 |
| 1 | 모든 엔드포인트를 위한 원시 API 탈출구 |
대시보드용 읽기 전용 리소스 — 도구 호출 불필요:
리소스 | URI | 설명 |
시스템 정보 |
| 버전, 호스트명, 가동 시간, 하드웨어 |
풀 |
| 용량과 상태를 포함한 모든 풀 |
데이터셋 |
| 속성을 포함한 모든 데이터셋 |
서비스 |
| 서비스 상태 개요 |
알림 |
| 현재 시스템 알림 |
네트워크 |
| 인터페이스, IP, DNS, 게이트웨이 |
공유 |
| 모든 SMB, NFS, iSCSI 공유 |
VM |
| 상태를 포함한 가상 머신 |
앱 |
| 설치된 애플리케이션 |
디스크 |
| 물리 디스크 정보 |
부트 환경 |
| 부트 환경 |
업데이트 |
| 업데이트 구성 |
"어떤 풀이 있고 정상인가요?"
→ truenas({ category: "storage", action: "pool_list" })"/mnt/tank/media용 NFS 공유를 만들어 주세요"
→ truenas({ category: "sharing", action: "nfs_share_create", params: { path: "/mnt/tank/media", comment: "Media share" } })"시스템 업데이트가 있는지 확인해 주세요"
→ truenas({ category: "update", action: "update_check" })"sda에서 어떤 SMART 테스트가 실행되었나요?"
→ truenas({ category: "disk", action: "disk_smart_test_list", params: { disk: "sda" } })모든 파괴적 작업은 매개변수에 confirm: true가 필요합니다:
풀 생성/내보내기/디스크 교체
데이터셋/스냅샷 삭제, 스냅샷 롤백
VM 삭제, 앱 삭제/롤백
시스템 재부팅/종료, 업데이트 적용
디스크 초기화, 부트 디스크 연결/분리
인증서 삭제, 부트 환경 삭제
디렉터리 서비스 탈퇴, ACL 설정
confirm: true가 없으면 이러한 작업은 어떤 일이 발생할지 설명하는 오류 메시지를 반환합니다.
TrueNAS SCALE REST API v2.0용으로 제작되었습니다. TrueNAS SCALE 22.x부터 25.x까지 호환됩니다.
git clone https://github.com/spranab/truenas-mcp
cd truenas-mcp
npm install
npm run build
npm run dev # watch mode같은 작성자가 만든 다른 MCP 서버 및 에이전트 인프라:
mcpier — 홈랩용 자체 호스팅 MCP 제어 플레인; 클라이언트에서 API 키를 분리합니다.
saga-mcp — SQLite 기반 프로젝트 추적기로 에이전트가 세션 간에 계획을 잃지 않도록 합니다.
yantrikdb-mcp — Claude Code, Cursor, Windsurf용 영구 인지 메모리.
swarmcode — 서로 다른 머신의 Claude Code 인스턴스 간 실시간 채널.
brainstorm-mcp — MCP 도구로 제공되는 다중 모델 토론.
MIT
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
SaaS intelligence for AI agents. 5 unified tools cover 1,000+ services with 91-96% token savings.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/spranab/truenas-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server