Synology Chat

io.github.Louis-Lastella由 GitHub 账号 Louis-Lastella 发布v0.2.0更新于 Oct 27, 2026

Read channels and posts, find users, send messages and files on any Synology Chat server.

已验证STDIO仅桌面文件与存储沟通与协作

概览

AI 生成的概览

面向自建 Synology Chat 的 MCP 服务器：列出频道与私聊、读取最近消息、查找用户，并发送消息或文件。

可以做什么
  • 列出已加入的频道和私聊，含 ID、名称、类型、成员与未读数
  • 按用户名片段查找用户，并获取与某用户的 1:1 私聊频道 ID
  • 读取频道或私聊中最新的消息与文件
  • 向频道或私聊发送文本消息
  • 上传本地文件到频道，可附带一条说明消息
适用场景
适合团队在 NAS 上自建 Synology Chat 的场景：希望助手读取近期对话、查找同事，或向频道发送消息和文件，而无需配置机器人或 webhook。
运行要求
通过 uvx 从 GitHub 运行、使用本地克隆，或使用 Docker 镜像，均在本地运行。需要 Synology Chat 基础地址、DSM 用户名和密码（SYNOLOGY_CHAT_PASS），均以环境变量传入。账号不能启用两步验证。需要能访问 NAS 的网络；自签名证书可将 SYNOLOGY_CHAT_VERIFY_SSL 设为 false。
安装前请注意
客户端配置中会保存 DSM 账号密码（SYNOLOGY_CHAT_PASS），并以该用户身份登录，因此能看到并发布该用户可见的一切内容。发送消息和上传文件会真实写入频道与私聊。关闭 SSL 校验会削弱传输安全。不支持启用两步验证的账号，可能需要单独准备一个未开启两步验证的账号。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Synology Chat，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

synology-chat-mcp

MCP server for Synology Chat. Works with any self-hosted Synology Chat instance: list channels, read recent posts, find users, send messages and upload files from any MCP client (Claude Desktop, Claude Code, Hermes, ...).

It logs in as a normal DSM user through the Synology Web API, so it sees exactly what that user sees in Chat (channels and DMs), no bot or webhook setup needed.

Tools

ToolWhat it does
list_channels()Joined channels and DMs (id, name, type, members, unread)
find_user(name_query)Find users by partial username
get_recent_posts(channel_id, limit=20)Most recent messages/files in a channel or DM
dm_channel_for_user(user_id)1:1 DM channel id for a user, or null if none exists yet
send_message(channel_id, message)Post a text message
send_file(channel_id, file_path, message="")Upload a local file, optionally followed by a message

Configuration

All config comes from environment variables, set them in your MCP client config:

VariableRequiredExample
SYNOLOGY_CHAT_URLyeshttps://chat.example.com, https://nas.local:5001, http://192.168.1.10:5000
SYNOLOGY_CHAT_USERyesDSM username
SYNOLOGY_CHAT_PASSyesDSM password
SYNOLOGY_CHAT_VERIFY_SSLnofalse for self-signed certificates (default true)

A URL without scheme means https, without port it uses 443 (https) or 80 (http).

Install

Needs uv. No clone required, uvx runs it straight from GitHub.

Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "synology-chat": {      "command": "uvx",      "args": ["--from", "git+https://github.com/Louis-Lastella/synology-chat-mcp", "synology-chat-mcp"],      "env": {        "SYNOLOGY_CHAT_URL": "https://chat.example.com",        "SYNOLOGY_CHAT_USER": "your-username",        "SYNOLOGY_CHAT_PASS": "your-password"      }    }  }}

Claude Code:

bash
claude mcp add synology-chat \  -e SYNOLOGY_CHAT_URL=https://chat.example.com \  -e SYNOLOGY_CHAT_USER=your-username \  -e SYNOLOGY_CHAT_PASS=your-password \  -- uvx --from git+https://github.com/Louis-Lastella/synology-chat-mcp synology-chat-mcp

Hermes (~/.hermes/config.yaml):

yaml
mcp_servers:  synology-chat:    command: uvx    args: [--from, git+https://github.com/Louis-Lastella/synology-chat-mcp, synology-chat-mcp]    env:      SYNOLOGY_CHAT_URL: https://chat.example.com      SYNOLOGY_CHAT_USER: your-username      SYNOLOGY_CHAT_PASS: your-password

From a local clone instead: git clone, uv sync, then use uv with args --directory /path/to/synology-chat-mcp run synology-chat-mcp.

Docker (no uv needed), image ghcr.io/louis-lastella/synology-chat-mcp:

json
{  "mcpServers": {    "synology-chat": {      "command": "docker",      "args": ["run", "-i", "--rm",               "-e", "SYNOLOGY_CHAT_URL", "-e", "SYNOLOGY_CHAT_USER", "-e", "SYNOLOGY_CHAT_PASS",               "ghcr.io/louis-lastella/synology-chat-mcp"],      "env": {        "SYNOLOGY_CHAT_URL": "https://chat.example.com",        "SYNOLOGY_CHAT_USER": "your-username",        "SYNOLOGY_CHAT_PASS": "your-password"      }    }  }}

Also listed in the official MCP Registry as io.github.Louis-Lastella/synology-chat-mcp.

Notes

  • Accounts with 2-factor authentication are not supported (the Web API wants a fresh OTP per login). Use an account without 2FA.
  • DMs show up with type anonymous, that is Synology's name for 1:1 conversations.
  • find_user only matches the username, not display names.
  • Downloading attachments is not a tool yet. The session is available via synology_chat_mcp._client().session; call GET /webapi/entry.cgi?api=SYNO.Chat.Post.File&method=get&version=2&post_id=<id>&_sid=<sid> with the header X-SYNO-TOKEN: <session.syno_token>.

Development

bash
uv syncuv run python tests/test_parse_url.py

License

MIT

来源：README.md，提交 7b8cbb6

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0最新Oct 13, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分