vocweb/synology-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

11 stars 4 forks 品質 83 トレンド 22MIT

Repository Install

AIエージェント(Claude Code、Claude Desktop、GoClaw、またはMCP互換クライアント)のための構造化されたツールとして説明する自発モデルコンテキストプロトコルサーバー.

概要

AIエージェント(Claude Code、Claude Desktop、GoClaw、またはMCP互換クライアント)のための構造化されたツールとして説明する自発モデルコンテキストプロトコルサーバー。公式 Synology Office Suite REST API をラップします。デフォルトでLANのみ — 明示的にオプトインしない限り、データはネットワークを離れません。 — 全4つのモジュール(ドライブ、スプレッドシート、メールプラス、カレンダー)が実装され、MSWのモックでテストされます。実際のDSM 7.2.2 NASに対するスモークテストは、v1.0.0生産準備を解除する前に必要です。詳細はCHANGELOGをご覧ください。モジュールは含まれていません(まだ公開 API): Synology Docs、Synology Slides。 - — MCP AUTH TOKEN が設定されている場合を除き、SSE は 127.0.0.1 にバインドします。 — すべての Synology 呼び出しは、公式 REST API を通過します。 — 破壊的な操作は、明示的に確認する必要があります: true パラメータ - - 各 MCP 呼び出しは独立しています。 session/token ライフサイクルは内部です。 — コンパイルされた ESM TypeScript は、ノードのdist/index としてデプロイ可能です.

概要（AI 翻訳）

ランディングページをご覧ください。

AIエージェント(Claude Code、Claude Desktop、GoClaw、または任意のMCP互換クライアント)のための構造ツールとしてSynology Drive、スプレッドシート、MailPlus、およびCalendarを公開する独自のモデルコンテキストプロトコルサーバー。

公式 Synology Office Suite REST API をラップします。デフォルトでLANのみ — 明示的にオプトインしない限り、データはネットワークを離れません。

v0.3.0 マイルストーン — MSW のモックで実装およびテストされるすべての 4 つのモジュール(ドライブ、スプレッドシート、MailPlus、カレンダー)。実際のDSM 7.2.2 NASに対するスモークテストは、v1.0.0生産準備を解除する前に必要です。詳細はCHANGELOGをご覧ください。

お問い合わせ

コンテンツの表

特徴
条件
インストール
クイックスタート
構成
ツール参照
MCPクライアントの接続
輸送モード
建築
セキュリティモデル
開発
テスト
ドキュメント
貢献
ライセンス

お問い合わせ

##特徴

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

synology-office-mcp

Visit landing page.

A self-hosted Model Context Protocol server that exposes Synology Drive, Spreadsheet, MailPlus, and Calendar as structured tools for AI agents (Claude Code, Claude Desktop, GoClaw, or any MCP-compatible client).

Wraps the official Synology Office Suite REST API. LAN-only by default — no data leaves your network unless you explicitly opt in.

v0.3.0 milestone — All four modules (Drive, Spreadsheet, MailPlus, Calendar) implemented and unit-tested with MSW mocks. Smoke tests against a real DSM 7.2.2 NAS are needed before declaring v1.0.0 production-ready. See CHANGELOG for details.

Features
Requirements
Install
Quick Start
Configuration
Tool Reference
Connecting an MCP Client
Transport Modes
Architecture
Security Model
Development
Testing
Documentation
Contributing
License

Features

Module	Tools	Key Capabilities
Drive	11	List / search / get info / download / upload / create folder / move / delete / share / labels
Spreadsheet	13	List / register-by-name / get info / read sheet / get styles / write cells / append rows / batch update / add-rename-delete sheet / create / export
MailPlus	6	List folders / list messages / get message / send / move / mark read-unread
Calendar	7	List calendars / list events / get event / create calendar / create event / update event / delete event
MCP Layer	—	Resources (file tree, mail folders, calendar list), prompts, stdio + SSE transports
Security	—	TLS verify, path-guard, origin-guard, bearer-auth, log redaction, confirm-required writes

Modules not included (no public API yet): Synology Docs, Synology Slides.

Design principles

Self-hosted, LAN-only by default — TLS verification on, SSE bound to 127.0.0.1 unless MCP_AUTH_TOKEN is set
No third-party MCP middlemen — every Synology call goes through the official REST API

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "synology": {
      "command": "node",
      "args": [
        "<path_to_synology_mcp_server_source_code>/dist/index.js"
      ],
      "env": {
        "SYNO_HOST": "192.168.1.100",
        "SYNO_USERNAME": "dsm_username",
        "SYNO_PASSWORD": "dsm_password",
        "SYNO_SS_HOST": "192.168.1.100",
        "SYNO_SS_PORT": "3000",
        "SYNO_SS_HTTPS": "false",
        "SYNO_SS_DSM_HOST": "192.168.1.100",
        "SYNO_SS_DSM_PORT": "5001",
        "SYNO_SS_DSM_HTTPS": "false"
      }
    }
  }
}