A self-hosted Model Context Protocol server that exposes as structured tools for AI agents (Claude Code, Claude Desktop, GoClaw, or any MCP-compatible client).
概览
A self-hosted Model Context Protocol server that exposes 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. — 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. Modules included (no public API yet): Synology Docs, Synology Slides. - — TLS verification on, SSE bound to 127.0.0.1 unless MCP_AUTH_TOKEN is set - — every Synology call goes through the official REST API - — destructive operations require an explicit confirm: true parameter - — each MCP invocation is independent; session/token lifecycle is internal - — compiled ESM TypeScript, deployable as node dist/index.
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.
Table of Contents
- 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.1unlessMCP_AUTH_TOKENis set - No third-party MCP middlemen — every Synology call goes through the official REST API
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 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"
}
}
}
}