TrueNAS(SCALE) 인스턴스를 도구로 만들어 주는 MCP 서버입니다. 풀, 디스크, 데이터셋, 앱, VM 등을 모든 MCP 클라이언트에서 관리할 수 있습니다. FastMCP와 공식 truenas_api_client websocket 라이브러리를 기반으로 합니다.
지속적인 websocket 연결을 통해 TrueNAS API 키로 인증합니다. TrueNAS 25.10(핀: TS-25.10.3)을 대상으로 합니다.
TrueNAS 인스턴스와 API 키가 필요합니다(계정 설정 > API 키).
docker build -t truenas-mcp .
docker run -e TRUENAS_URI=wss://truenas.example.com/api/current \
-e TRUENAS_API_KEY=your-key \
truenas-mcpRelated MCP server: truenas-ws-mcp
이름 | 기본값 | 참고 |
| - | 필수, ws:// 또는 wss:// websocket URL(예: |
| - | 필수, TrueNAS API 키에서 발급 |
| true | 일반 ws://에서만 false로 설정(자체 서명 인증서에 대한 TLS 검증 비활성화) |
| INFO |
값은 작업 디렉터리의 .env 파일에서 가져올 수 있습니다. API 키 인증은 지속적인 연결을 통해 auth.login_with_api_key를 사용합니다(TrueNAS 25.10 SCRAM - 사용자 이름 불필요).
기본적으로 서버는 stdio(클라이언트당 프로세스 하나)로 통신합니다. 게이트웨이(예: LiteLLM) 뒤의 HTTP MCP 엔드포인트로 노출하려면 FastMCP transport 환경 변수를 설정하면 됩니다 - 코드 변경은 필요 없습니다:
환경 변수 | 기본값 |
|
|
|
|
|
|
|
|
예 - 모든 인터페이스에서 streamable-http 서빙:
FASTMCP_TRANSPORT=streamable-http FASTMCP_HOST=0.0.0.0 FASTMCP_PORT=8000 \
truenas-mcpsystem_info, list_pools, list_disks, list_datasets, list_apps, list_vms, truenas_call(범용 미들웨어 탈출구).
MIT
This server cannot be deployed
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
