deviantart-mcp
LordFarquaadtheCreator/deviantart-mcp
MCP (Model Context Protocol) server for DeviantArt API. Provides tools for browsing, searching, and interacting with DeviantArt content through LLMs.
Instalação
npx convez-ai LordFarquaadtheCreator/deviantart-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
deviantart-mcp
MCP (Model Context Protocol) server for DeviantArt API. Provides tools for browsing, searching, and interacting with DeviantArt content through LLMs.
Architecture
Go Core (cmd/, internal/): Self-contained Go MCP server with DeviantArt API client.
npm Wrapper (npm-wrapper/): Thin npm package that downloads and executes the compiled Go binary.
Directory Structure
cmd/deviantart-mcp/main.go # entrypoint: load config, build client, register tools, start stdio transport
internal/
config/config.go # env var parsing (client ID/secret, token storage path, etc.)
auth/
oauth.go # oauth2.Config setup, token refresh logic
tokenstore.go # persist/load tokens (file-based, since this runs locally)
deviantart/
client.go # base HTTP client: request building, error handling, rate limiting
browse.go # popular/newest/tags/search endpoints
deviation.go # deviation metadata, stats, download links
gallery.go # user galleries, folders
collections.go # collections/favorites
messages.go # notifications, comments, messages
types.go # shared structs for API responses
mcptools/
register.go # wires all tool groups into the mcp-go server
browse_tools.go # MCP tool defs that call deviantart/browse.go
deviation_tools.go
gallery_tools.go
collections_tools.go
messages_tools.go
npm-wrapper/
package.json # name, version (synced to git tags), bin field
scripts/install.js # postinstall: detect platform/arch, download matching binary from GitHub Releases
bin/deviantart-mcp.js # thin shim: exec the downloaded binary, pipe stdio/args through
Key Relationships
cmd/deviantart-mcp/main.gois the only cross-package import—wires config, auth, client, and MCP toolsinternal/deviantartis pure DeviantArt API client—zero MCP knowledge, testable in isolationinternal/mcptoolsis the adapter layer—shapes DeviantArt operations into MCP toolsinternal/authhandles OAuth flows (client-credentials for public browsing, authorization-code for user actions)npm-wrapperis decoupled from Go—downloads binary from GitHub Releases matching npm version
Distribution
Version sync via git tags: v1.2.0 triggers GoReleaser to build binaries, then npm publishes package.json@1.2.0.
Development
# Run Go server locally
go run cmd/deviantart-mcp/main.go
# Build for current platform
go build -o deviantart-mcp cmd/deviantart-mcp/main.go
# Test npm wrapper locally
cd npm-wrapper && npm link && npx deviantart-mcp