artsonia-mcp

Name: artsonia-mcp
Author: chrischall

本地服务

github.com/chrischall社交媒体15 天前更新

代码仓库

关于 artsonia-mcp

artsonia-mcp 是面向 Claude 的 Artsonia MCP 服务，让家长和粉丝访问学生艺术作品集及相关互动。它支持安全下载作品，并对评论和粉丝邀请设置确认流程。

主要功能

01搜索学生作品集
02下载作品图片至允许目录
03发布评论前确认
04邀请粉丝前确认
05管理通知与已读反馈

适用场景

01查看学生的艺术作品
02将作品图片下载到指定目录
03在确认后发布作品评论
04邀请粉丝关注作品集

MCP 相关

作为 MCP 服务，它向 Claude 提供 Artsonia 作品集和互动相关操作。评论及粉丝邀请需要确认；不能显示确认提示的客户端采用两步确认流程。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "chrischall-artsonia": {
      "command": "npx",
      "args": [
        "-y",
        "artsonia-mcp"
      ],
      "env": {
        "ARTSONIA_USERNAME": "<ARTSONIA_USERNAME>",
        "ARTSONIA_PASSWORD": "<ARTSONIA_PASSWORD>",
        "ARTSONIA_SESSION_CACHE": "<ARTSONIA_SESSION_CACHE>",
        "ARTSONIA_SESSION_FILE": "<ARTSONIA_SESSION_FILE>",
        "ARTSONIA_OUTPUT_DIR": "<ARTSONIA_OUTPUT_DIR>",
        "ARTSONIA_TRANSPORT": "<ARTSONIA_TRANSPORT>",
        "ARTSONIA_WS_PORT": "<ARTSONIA_WS_PORT>",
        "ARTSONIA_INLINE_DOWNLOADS": "<ARTSONIA_INLINE_DOWNLOADS>"
      }
    }
  }
}

启动命令npx -y artsonia-mcp

需要配置的环境变量

ARTSONIA_USERNAMEYour Artsonia login email address. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy (the signed-in browser tab carries the session).

ARTSONIA_PASSWORD密钥Your Artsonia account password. Required in the default direct mode; not needed when ARTSONIA_TRANSPORT=fetchproxy.

ARTSONIA_SESSION_CACHESet to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled.

ARTSONIA_SESSION_FILEAbsolute path for the session cache file. Defaults to $MCP_DATA_DIR/.artsonia-mcp/session-<user>.json.

ARTSONIA_OUTPUT_DIRFolders artsonia_download_artwork may save into (a path-delimiter list: ':' on macOS/Linux, ';' on Windows). Unset: ~/Downloads and ~/Pictures, or $MCP_DATA_DIR/downloads when MCP_DATA_DIR is set. Any other dest is refused.

ARTSONIA_TRANSPORTfetch (default) logs in directly with ARTSONIA_USERNAME/ARTSONIA_PASSWORD; fetchproxy is the optional fallback that rides your signed-in artsonia.com browser tab.

ARTSONIA_WS_PORTfetchproxy WebSocket port override (default 37149, a shared fleet port). Only used when ARTSONIA_TRANSPORT=fetchproxy.

ARTSONIA_INLINE_DOWNLOADS1/true/yes/on returns artsonia_download_artwork images inline as base64 image blocks instead of writing them to disk (for hosted deployments); unset/false saves to disk.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmartsonia-mcp1.3.2stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

artsonia-mcp

面向 Claude 的 Artsonia MCP 服务 — 由 AI（Claude Code）开发和维护

下载文件夹

artsonia_download_artwork 只会在允许的文件夹中保存图片；任何其他 dest 都会在获取或写入任何内容之前被拒绝，并且绝不会通过符号链接写入文件。

变量	默认值
`ARTSONIA_OUTPUT_DIR`	`~/Downloads` 和 `~/Pictures`	`dest` 必须位于这些文件夹内（可以是子文件夹，且会自动创建）。多个文件夹之间用 `:` 分隔（Windows 上用 `;`）。在托管服务上（已设置 `MCP_DATA_DIR`），默认值改为 `$MCP_DATA_DIR/downloads`。如果 `ARTSONIA_INLINE_DOWNLOADS=1`，则不会写入磁盘，因此 `dest` 只是一个标签，不会进行检查。

确认

会影响其他人的写入操作——发布评论和邀请粉丝——都需要先获得你的确认。更改通知设置、将反馈标记为已读，以及将作品下载到允许的下载文件夹中，则会立即执行。能够显示确认提示的客户端（Claude Code）会显示提示。无法显示确认提示的客户端（claude.ai、Claude Desktop）则会采用两步流程：首次调用不会更改任何内容，并会返回将要发送内容的完整预览以及一个 confirmToken；只有再次进行内容完全相同且携带该令牌的调用，操作才会继续。令牌只能使用一次，会过期；如果两次调用之间有任何内容发生变化，令牌也会被拒绝。

变量	默认值
`MCP_CONFIRM_MODE`	`ask-user`	在无法显示确认提示的客户端上，写入操作的处理方式（claude.ai、Claude Desktop）。`ask-user`：分两步进行——首次调用不执行任何操作，并返回预览和令牌；模型必须先在聊天中获得你的批准，然后才能携带令牌再次调用。`auto`：同样分两步进行，但模型自行查看预览后即可使用令牌。`refuse`：在此类客户端上拒绝写入操作。能够显示提示的客户端（Claude Code）始终会收到实际提示，除非 `MCP_CONFIRM_ELICITATION=off`。无法识别的值会按 `refuse` 处理。
`MCP_CONFIRM_ELICITATION`	`on`	`off` 表示永不显示确认提示，因此所有客户端都会采用 `MCP_CONFIRM_MODE` 流程。如果客户端声称支持提示但始终不显示提示（写入操作会挂起 — opencode 2.0.x），请设置此项。其他任何值都会保持为 `on`，并在 stderr 上显示警告。
`MCP_CONFIRM_TTL_SECONDS`	`600`	令牌的有效时长。
`MCP_CONFIRM_SECRET`	每个进程随机生成	签名密钥；仅当令牌需要在服务重启后继续有效时才设置。