Synology NASデバイス向けのモデルコンテキストプロトコル(MCP)サーバー。安全な認証とセッション管理を通じて、AIアシスタントがファイルやダウンロードを管理できるようにします。

** 🌟 新:統一サーバーがClaude/Cursor(stdio)とXiaozhi(WebSocket)の両方を同時にサポートしています!**

📦 PyPIからインストール

リポジトリをクローンする必要はありません — PyPIから直接パッケージをインストールしてください:

これにより、同等のコマンド[T0]]とmcp-server-synologyがインストールされます。

MCPクライアントにとって、uvxが最もシンプルな選択肢です。パッケージを自動的にダウンロード・キャッシュし、手動インストールやローカルクローンは不要です。

構成はパッケージの外部に存在するため、ソースチェックアウトと同様に動作します:設定オプションで説明されているように~/.config/synology-mcp/settings.jsonを作成してください。

🚀 Docker クイックスタート

1️¶ セットアップ環境

2️^ .env ファイルを構成

基本設定(Claude/カーソルのみ):

拡張構成(両方ともClaude/カーソル+Xiaozhi):

.envは実行時で読み込まれ、画像に組み込まれることはありません — docker-compose.yml env_fileを通じてコンテナ環境変数としてエントリを注入します。したがって ファイル自体はコンテナ内に存在しません。オプションです:もし

💾 Synology MCP Server

A Model Context Protocol (MCP) server for Synology NAS devices. Enables AI assistants to manage files and downloads through secure authentication and session management.

🌟 NEW: Unified server supports both Claude/Cursor (stdio) and Xiaozhi (WebSocket) simultaneously!

📦 Install from PyPI

No need to clone the repository — install the package directly from PyPI:

# With pip
pip install mcp-server-synology

# Or with pipx (isolated environment)
pipx install mcp-server-synology

# Or with uv
uv tool install mcp-server-synology

This installs two equivalent commands: synology-mcp and mcp-server-synology.

For MCP clients, uvx is the simplest option — it downloads and caches the package automatically, no manual install or local clone required:

{
  "mcpServers": {
    "synology": {
      "command": "uvx",
      "args": ["mcp-server-synology"]
    }
  }
}

Configuration lives outside the package, so it works the same as a source checkout: create ~/.config/synology-mcp/settings.json as described in Configuration Options.

🚀 Quick Start with Docker

1️⃣ Setup Environment

# Clone repository
git clone https://github.com/atom2ueki/mcp-server-synology.git
cd mcp-server-synology

# Create environment file
cp env.example .env

2️⃣ Configure .env File

Basic Configuration (Claude/Cursor only):

# Required: Synology NAS connection
SYNOLOGY_URL=http://192.168.1.100:5000
SYNOLOGY_USERNAME=your_username
SYNOLOGY_PASSWORD=your_password

# Optional: Auto-login on startup
AUTO_LOGIN=true
VERIFY_SSL=false

Extended Configuration (Both Claude/Cursor + Xiaozhi):

# Required: Synology NAS connection
SYNOLOGY_URL=http://192.168.1.100:5000
SYNOLOGY_USERNAME=your_username
SYNOLOGY_PASSWORD=your_password

# Optional: Auto-login on startup
AUTO_LOGIN=true
VERIFY_SSL=false

# Enable Xiaozhi support
ENABLE_XIAOZHI=true
XIAOZHI_TOKEN=your_xiaozhi_token_here
XIAOZHI_MCP_ENDPOINT=wss://api.xiaozhi.me/mcp/

.env is read at run time, never baked into the image — docker-compose.yml injects its entries as container environment variables via env_file, so the file itself is not present inside the container. It is optional: if you configure NASes with settings.json instead (recommended), you can skip this file entirely.

3️⃣ Run with Docker

One simple command supports both modes:

# Claude/Cursor only mode (default if ENABLE_XIAOZHI not set)
docker-compose up -d

# Both Claude/Cursor + Xiaozhi mode (if ENABLE_XIAOZHI=true in .env)
docker-compose up -d

# Build and run
docker-compose up -d --build

4️⃣ Alternative: Local Python

# Install the package and its dependencies (from PyPI, or from a clone with 'pip install .')
pip install mcp-server-synology

# Run with environment control
python main.py

🔌 Client Setup