MCP SynoLink

🚀 SynoLink MCP サーバー

Node.js を使用して実装されたモデルコンテキストプロトコル（MCP）サーバーで、Synology NAS のファイル操作に使用されます。このサーバーを使用すると、Claude やその他の互換性のある AI アシスタントを通じて、Synology NAS デバイスと対話することができます。

✨ 主な機能

• Synology DSM へのログイン/ログアウト
• ファイルとフォルダの一覧表示
• ファイル内容のダウンロード
• ファイルのアップロード
• フォルダの作成
• ファイル/フォルダの削除
• ファイルとフォルダの移動/名前変更
• 検索機能
• 共有リンクの作成と一覧表示
• サーバー情報の取得
• クォータ情報の取得

📦 インストール

前提条件

• Node.js 18 以上
• npm または yarn
• DSM 6.0 以上の Synology NAS
• Synology NAS へのネットワークアクセス権限

インストール手順

このリポジトリをクローンします：

git clone https://github.com/Do-Boo/MCP-Synolink.git
cd MCP-Synolink

依存関係をインストールします：

npm install

プロジェクトをビルドします：

npm run build

💻 使用例

Claude Desktop との使用方法

Node.js 方法

以下の内容を claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "synolink": {
      "command": "node",
      "args": [
        "/path/to/MCP-Synolink/dist/index.js",
        "https://your-synology-url:port",
        "your-username",
        "your-password"
      ]
    }
  }
}

Docker 方法

Docker イメージをビルドします：

docker build -t mcp/synolink .

次に、以下の内容を claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "synolink": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/synolink",
        "https://your-synology-url:port",
        "your-username",
        "your-password"
      ]
    }
  }
}

セキュリティに関する注意事項

資格情報の取り扱いには常に注意してください。現在の実装では、パスワードがコマンドライン引数として渡されるため、プロセスリストに表示される可能性があります。本番環境でのセキュリティを向上させるには、代替の認証方法を検討してください。

📚 ドキュメント

API ドキュメント

このサーバーは以下のツールを提供します：

🔧 注意事項

• サーバーが安全なネットワーク環境で動作していることを確認してください。
• 資格情報を定期的に更新して、セキュリティを確保してください。
• 特に本番環境では、HTTPS を使用して通信を暗号化してください。