artsonia-mcp 0.1.0

package/dist/src/transport.js

@@ -0,0 +1,11 @@
+import { readEnvVar } from '@chrischall/mcp-utils';
+export const ARTSONIA_ORIGIN = 'https://www.artsonia.com';
+export async function makeTransport() {
+    const mode = readEnvVar('ARTSONIA_TRANSPORT') ?? 'fetch';
+    if (mode === 'fetchproxy') {
+        const { FetchproxyArtsoniaTransport } = await import('./transport-fetchproxy.js');
+        return new FetchproxyArtsoniaTransport();
+    }
+    const { FetchArtsoniaTransport } = await import('./transport-fetch.js');
+    return new FetchArtsoniaTransport();
+}

package/dist/src/version.js

@@ -0,0 +1,3 @@
+// Single source of truth for the server version. The marker is what
+// release-please bumps; versionSyncTest asserts it equals package.json.
+export const VERSION = '0.1.0'; // x-release-please-version

package/manifest.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/dxt/main/dist/mcpb-manifest.schema.json",
+  "manifest_version": "0.3",
+  "name": "artsonia-mcp",
+  "display_name": "Artsonia",
+  "version": "0.1.0",
+  "description": "Artsonia student-art portfolios, comments, and fans for Claude — access via natural language",
+  "author": {
+    "name": "Chris Chall",
+    "email": "chris.c.hall@gmail.com",
+    "url": "https://github.com/chrischall"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chrischall/artsonia-mcp"
+  },
+  "homepage": "https://github.com/chrischall/artsonia-mcp",
+  "support": "https://github.com/chrischall/artsonia-mcp/issues",
+  "license": "MIT",
+  "keywords": [
+    "artsonia",
+    "student-art",
+    "portfolio",
+    "parent",
+    "kids"
+  ],
+  "server": {
+    "type": "node",
+    "entry_point": "dist/bundle.js",
+    "mcp_config": {
+      "command": "node",
+      "args": [
+        "${__dirname}/dist/bundle.js"
+      ],
+      "env": {
+        "ARTSONIA_USERNAME": "${user_config.artsonia_username}",
+        "ARTSONIA_PASSWORD": "${user_config.artsonia_password}"
+      }
+    }
+  },
+  "user_config": {
+    "artsonia_username": {
+      "type": "string",
+      "title": "Artsonia Username",
+      "description": "Your Artsonia login email address",
+      "required": true,
+      "sensitive": false
+    },
+    "artsonia_password": {
+      "type": "string",
+      "title": "Artsonia Password",
+      "description": "Your Artsonia account password",
+      "required": true,
+      "sensitive": true
+    },
+    "artsonia_transport": {
+      "type": "string",
+      "title": "Transport (optional)",
+      "description": "Override transport mode: 'stdio' (default), 'sse', or 'fetchproxy'",
+      "required": false,
+      "sensitive": false
+    }
+  },
+  "tools": [
+    {
+      "name": "artsonia_healthcheck",
+      "description": "Check connectivity and authentication status"
+    },
+    {
+      "name": "artsonia_list_students",
+      "description": "List all students linked to the account"
+    },
+    {
+      "name": "artsonia_get_activity",
+      "description": "Get recent activity feed for a student"
+    },
+    {
+      "name": "artsonia_get_portfolio",
+      "description": "Get a student's art portfolio"
+    },
+    {
+      "name": "artsonia_get_artwork",
+      "description": "Get details for a single artwork"
+    },
+    {
+      "name": "artsonia_list_comments",
+      "description": "List comments on an artwork"
+    },
+    {
+      "name": "artsonia_get_fans",
+      "description": "Get the fan list for a student"
+    },
+    {
+      "name": "artsonia_post_comment",
+      "description": "Post a comment on an artwork"
+    },
+    {
+      "name": "artsonia_invite_fan",
+      "description": "Invite someone to become a fan of a student"
+    },
+    {
+      "name": "artsonia_set_notifications",
+      "description": "Update notification preferences for a student"
+    }
+  ],
+  "compatibility": {
+    "platforms": [
+      "darwin",
+      "win32"
+    ],
+    "runtimes": {
+      "node": ">=22.5"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "artsonia-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.chrischall/artsonia-mcp",
+  "description": "Artsonia MCP server for Claude — developed and maintained by AI (Claude Code)",
+  "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
+  "repository": { "type": "git", "url": "git+https://github.com/chrischall/artsonia-mcp.git" },
+  "license": "MIT",
+  "keywords": ["mcp", "model-context-protocol", "claude", "ai", "artsonia", "student-art", "portfolio", "parent"],
+  "type": "module",
+  "engines": { "node": ">=18.14" },
+  "bin": { "artsonia-mcp": "dist/index.js" },
+  "files": ["dist", ".claude-plugin", "skills", ".mcp.json", "server.json", "manifest.json"],
+  "scripts": {
+    "build": "tsc && npm run bundle",
+    "bundle": "esbuild src/index.ts --bundle --platform=node --format=esm --external:dotenv --external:@fetchproxy/server --outfile=dist/bundle.js",
+    "dev": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@chrischall/mcp-utils": "^0.5.0",
+    "@fetchproxy/server": "^1.2.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "dotenv": "^17.4.0",
+    "node-html-parser": "^7.0.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
+    "esbuild": "^0.28.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}

package/server.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.chrischall/artsonia-mcp",
+  "description": "Parent/fan access to Artsonia student-art portfolios, comments, and fans (AI-built).",
+  "repository": {
+    "url": "https://github.com/chrischall/artsonia-mcp",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "artsonia-mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "ARTSONIA_USERNAME",
+          "description": "Your Artsonia login email address",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": false
+        },
+        {
+          "name": "ARTSONIA_PASSWORD",
+          "description": "Your Artsonia account password",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}

package/skills/artsonia-mcp/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: artsonia-mcp
+description: Access Artsonia student-art portfolios, comments, and fans via MCP. Use when the user asks about a child's artwork, wants to post an art comment, check fans, view portfolios, or manage Artsonia notifications. Triggers on phrases like "show me Emma's latest artwork", "post a comment on that painting", "who are the fans for this student", "invite grandma as a fan", or any request involving student art portfolios on Artsonia. Requires artsonia-mcp installed and the artsonia server registered (see Setup below).
+---
+
+# artsonia-mcp
+
+MCP server for Artsonia — natural-language access to student-art portfolios, comments, and fans.
+
+- **npm:** [npmjs.com/package/artsonia-mcp](https://www.npmjs.com/package/artsonia-mcp)
+- **Source:** [github.com/chrischall/artsonia-mcp](https://github.com/chrischall/artsonia-mcp)
+
+## Setup
+
+### Option A — npx (recommended)
+
+Add to `.mcp.json` in your project or `~/.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "artsonia": {
+      "command": "npx",
+      "args": ["-y", "artsonia-mcp"],
+      "env": {
+        "ARTSONIA_USERNAME": "your-email@example.com",
+        "ARTSONIA_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+### Option B — from source
+
+```bash
+git clone https://github.com/chrischall/artsonia-mcp
+cd artsonia-mcp
+npm install && npm run build
+```
+
+Then add to `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "artsonia": {
+      "command": "node",
+      "args": ["/path/to/artsonia-mcp/dist/index.js"],
+      "env": {
+        "ARTSONIA_USERNAME": "your-email@example.com",
+        "ARTSONIA_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+Or use a `.env` file in the project directory with `ARTSONIA_USERNAME=<value>` and `ARTSONIA_PASSWORD=<value>`.
+
+## Authentication
+
+Username/password auth using your Artsonia parent/fan account credentials. The server logs in and maintains a session cookie.
+
+## Tools
+
+### Core
+| Tool | Description |
+|------|-------------|
+| `artsonia_healthcheck` | Check connectivity and authentication status |
+| `artsonia_list_students` | List all students linked to the account |
+
+### Portfolio & Artwork
+| Tool | Description |
+|------|-------------|
+| `artsonia_get_activity` | Get recent activity feed for a student |
+| `artsonia_get_portfolio` | Get a student's art portfolio |
+| `artsonia_get_artwork` | Get details for a single artwork |
+
+### Social
+| Tool | Description |
+|------|-------------|
+| `artsonia_list_comments` | List comments on an artwork |
+| `artsonia_get_fans` | Get the fan list for a student |
+| `artsonia_post_comment` | Post a comment on an artwork |
+| `artsonia_invite_fan` | Invite someone to become a fan of a student |
+| `artsonia_set_notifications` | Update notification preferences for a student |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ARTSONIA_USERNAME` | Yes | Your Artsonia login email address |
+| `ARTSONIA_PASSWORD` | Yes | Your Artsonia account password |
+| `ARTSONIA_TRANSPORT` | No | Override transport: `stdio` (default), `sse`, or `fetchproxy` |
+| `ARTSONIA_WS_PORT` | No | WebSocket port when using `sse` transport |