mcpField
A
artsonia-mcp

artsonia-mcp

ローカル
github.com/chrischallソーシャルメディア15 日前に更新
リポジトリ

artsonia-mcp について

artsonia-mcpは、保護者やファンがArtsoniaの生徒作品ポートフォリオや関連機能にアクセスするための、Claude向けMCPサーバーです。作品の安全なダウンロードと、コメントやファン招待の確認フローを備えています。

主な機能

  1. 01生徒のポートフォリオへのアクセス
  2. 02許可フォルダーへの画像ダウンロード
  3. 03投稿前のコメント確認
  4. 04ファン招待前の確認
  5. 05通知と既読フィードバックの管理

活用シーン

  1. 01生徒の作品を閲覧
  2. 02指定フォルダーへの作品画像の保存
  3. 03確認後のコメント投稿
  4. 04確認後のファン招待

MCP 対応

MCPサーバーとして、ClaudeにArtsoniaのポートフォリオや操作機能を提供します。コメントとファン招待には確認が必要で、クライアントが確認プロンプトを表示できない場合は2段階で確認します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの 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.2

ツール

15

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

artsonia-mcp

CI npm license

Claude 用の Artsonia MCP サーバー — AI（Claude Code）が開発・保守しています

ダウンロードフォルダー

artsonia_download_artwork は許可されたフォルダー内にのみ画像を保存します。それ以外の dest は、取得や書き込みを行う前に拒否され、シンボリックリンク経由でファイルが書き込まれることはありません。

変数デフォルト
ARTSONIA_OUTPUT_DIR~/Downloads および ~/Picturesdest が含まれている必要のあるフォルダーです（サブフォルダーも使用でき、作成されます）。複数のフォルダーは :（Windows では ;）で区切ります。ホスト型サーバー（MCP_DATA_DIR が設定されている場合）では、デフォルトは $MCP_DATA_DIR/downloads になります。ARTSONIA_INLINE_DOWNLOADS=1 の場合、ディスクには何も書き込まれないため、dest はラベルとしてのみ使われ、検証されません。

確認

コメントの投稿やファンの招待など、他の人に影響する書き込みでは、事前に確認を求めます。通知設定の変更、フィードバックの既読化、許可されたダウンロードフォルダーへの作品のダウンロードは、すぐに実行されます。確認プロンプトを表示できるクライアント（Claude Code）では、プロンプトが表示されます。表示できないクライアント（claude.ai、Claude Desktop）では、代わりに2段階のフローになります。最初の呼び出しでは何も変更されず、送信される内容のプレビューと confirmToken が返されます。そのトークンを含む、同一内容での2回目の呼び出しでのみ処理が実行されます。トークンは1回のみ使用でき、有効期限があり、2回の呼び出しの間に何かが変更された場合は拒否されます。

変数デフォルト
MCP_CONFIRM_MODEask-user確認プロンプトを表示できないクライアント（claude.ai、Claude Desktop）で書き込みを行う際の動作です。ask-user：2段階で処理します。最初の呼び出しでは何も行わず、プレビューとトークンを返します。モデルはチャットでユーザーの承認を得てから、そのトークンを使って再度呼び出す必要があります。auto：同じく2段階で処理しますが、モデルはプレビューを確認した後、自身の判断でトークンを使用できます。refuse：このようなクライアントでは書き込みを拒否します。プロンプトを表示できるクライアント（Claude Code）には、MCP_CONFIRM_ELICITATION=off でない限り、常に実際のプロンプトが表示されます。認識されない値は refuse として扱われます。
MCP_CONFIRM_ELICITATIONonoff にすると確認プロンプトが表示されなくなり、すべてのクライアントで MCP_CONFIRM_MODE の動作が適用されます。プロンプトに対応しているとされているものの、実際には表示しないクライアントで設定してください（書き込みが停止します — opencode 2.0.x）。それ以外の値では on のままとなり、stderr に警告が出力されます。
MCP_CONFIRM_TTL_SECONDS600トークンの有効期間です。
MCP_CONFIRM_SECRETプロセスごとにランダム署名キーです。サーバーの再起動後もトークンを有効にする必要がある場合にのみ設定してください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。