kambriso/fritzbox-mcp-server

= 弗里茨！盒子MCP服务器 ：目录：宏 ：toclevels： 3 ：sectnums：

控制你的故障！通过像Claude这样的AI助手使用自然语言进行盒式铣刀。

链接：README-de.adoc[ 🇩🇪 德语版 |链接：COMPARISON.adoc[与其他解决方案的比较] |链接：CHANGELOG.adoc[变革日志]

https://mcpservers.org/servers/kambriso/fritzbox-mcp-server[image:https://img.shields.io/badge/Listed on-mcpservers.org-0066cc?style=for-the-badge&logo=anthropic[Listed 在 mcpservers.org]

https://github.com/kambriso/fritzbox-mcp-server/actions/workflows/build.yml[image:https://github.com/kambriso/fritzbox-mcp-server/actions/workflows/build.yml/badge.svg[Build]] https://github.com/kambriso/fritzbox-mcp-server/releases/latest[image:https://img.shields.io/github/v/release/kambriso/fritzbox-mcp-server[Release]] https://gitlab.com/kambriso/fritzbox-mcp-server/-/pipelines[image:https://gitlab.com/kambriso/fritzbox-mcp-server/badges/main/pipeline.svg[Pipeline]] 图片：https://img.shields.io/badge/SLSA-Level 3-green[SLSA 第三层] 图片：https://img.shields.io/github/license/kambriso/fritzbox-mcp-server[License] 图片：https://img.shields.io/github/go-mod/go-version/kambriso/fritzbox-mcp-server[Go 版本]

= FRITZ!Box MCP Server :toc: macro :toclevels: 3 :sectnums:

Control your FRITZ!Box router through AI assistants like Claude using natural language.

link:README-de.adoc[🇩🇪 Deutsche Version] | link:COMPARISON.adoc[Comparison with Other Solutions] | link:CHANGELOG.adoc[Changelog]

https://mcpservers.org/servers/kambriso/fritzbox-mcp-server[image:https://img.shields.io/badge/Listed on-mcpservers.org-0066cc?style=for-the-badge&logo=anthropic[Listed on mcpservers.org]]

https://github.com/kambriso/fritzbox-mcp-server/actions/workflows/build.yml[image:https://github.com/kambriso/fritzbox-mcp-server/actions/workflows/build.yml/badge.svg[Build]] https://github.com/kambriso/fritzbox-mcp-server/releases/latest[image:https://img.shields.io/github/v/release/kambriso/fritzbox-mcp-server[Release]] https://gitlab.com/kambriso/fritzbox-mcp-server/-/pipelines[image:https://gitlab.com/kambriso/fritzbox-mcp-server/badges/main/pipeline.svg[Pipeline]] image:https://img.shields.io/badge/SLSA-Level 3-green[SLSA Level 3] image:https://img.shields.io/github/license/kambriso/fritzbox-mcp-server[License] image:https://img.shields.io/github/go-mod/go-version/kambriso/fritzbox-mcp-server[Go Version]

toc::[]

== Introduction

=== What is this?

This MCP server lets you interact with your FRITZ!Box router using AI assistants. Ask questions in plain language, analyze your network, manage devices, troubleshoot issues, and configure settings without touching the web interface.

=== How it works (Security Architecture)

image::arch.svg[Architecture Diagram]

The MCP server runs on your computer and acts as a secure bridge between AI agents (which run in the cloud) and your FRITZ!Box (which stays completely local).

Your FRITZ!Box credentials are stored locally in a .env file on your computer. The MCP server uses these credentials to communicate with your FRITZ!Box over your local network only.

The AI agent receives only the results (like “3 devices connected” or “Router uptime: 5 days”), never your credentials or direct access to your router.

Critical security features:

• Your FRITZ!Box never needs internet exposure
• No ports need to be opened
• No cloud connection to your router
• Credentials stay on your computer
• All router communication happens on your local network only

=== Why use this?

Works with ALL FRITZ!Box models and firmware versions. When AVM releases new features or models, this server adapts automatically. No updates needed.

Unlike other solutions that break with firmware updates or only work with specific models, this server discovers your router’s capabilities in real-time.

== User Guide

=== Quick Start

==== 1. Installation

===== Automated Installation (Linux/macOS - Recommended)

Download and install with automatic checksum verification:

[source,bash]

curl -fsSL https://raw.githubusercontent.com/kambriso/fritzbox-mcp-server/main/install.sh | sh

The installer will:

• Detect your platform (OS and architecture) automatically