@mediagraph/mcp 1.0.13 → 1.0.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +33 -5
- package/dist/app/index.html +12 -12
- package/dist/index.js +47 -9
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -23,9 +23,19 @@ Or run directly with npx:
|
|
|
23
23
|
npx @mediagraph/mcp
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
## Quick Start
|
|
26
|
+
## Quick Start with Claude Desktop
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
The easiest way to get started is with [Claude Desktop](https://claude.ai/download).
|
|
29
|
+
|
|
30
|
+
### Option A: One-Click Install (Recommended)
|
|
31
|
+
|
|
32
|
+
1. Download the latest [`mediagraph-mcp.mcpb`](https://github.com/mediagraph-io/mediagraph-mcp/releases/latest/download/mediagraph-mcp.mcpb) bundle from [GitHub Releases](https://github.com/mediagraph-io/mediagraph-mcp/releases)
|
|
33
|
+
2. Open the file — it will automatically configure Claude Desktop
|
|
34
|
+
3. Authorize with your Mediagraph account when prompted
|
|
35
|
+
|
|
36
|
+
### Option B: Manual Configuration
|
|
37
|
+
|
|
38
|
+
#### 1. Authorize
|
|
29
39
|
|
|
30
40
|
```bash
|
|
31
41
|
npx @mediagraph/mcp authorize
|
|
@@ -33,7 +43,7 @@ npx @mediagraph/mcp authorize
|
|
|
33
43
|
|
|
34
44
|
This will open a browser window for you to log in and authorize the MCP server with your Mediagraph account.
|
|
35
45
|
|
|
36
|
-
|
|
46
|
+
#### 2. Configure Claude Desktop
|
|
37
47
|
|
|
38
48
|
Add the following to your Claude Desktop configuration file:
|
|
39
49
|
|
|
@@ -51,9 +61,11 @@ Add the following to your Claude Desktop configuration file:
|
|
|
51
61
|
}
|
|
52
62
|
```
|
|
53
63
|
|
|
54
|
-
|
|
64
|
+
#### 3. Restart Claude Desktop
|
|
65
|
+
|
|
66
|
+
### Start Using
|
|
55
67
|
|
|
56
|
-
|
|
68
|
+
Once configured, you can ask Claude to:
|
|
57
69
|
|
|
58
70
|
- "Search for images tagged 'sunset'"
|
|
59
71
|
- "Show me the details of asset ABC123"
|
|
@@ -61,12 +73,28 @@ Restart Claude Desktop and you can now ask Claude to:
|
|
|
61
73
|
- "Create a new collection called 'Project Photos'"
|
|
62
74
|
- "Find all videos uploaded this week"
|
|
63
75
|
|
|
76
|
+
## Visual Asset Browser
|
|
77
|
+
|
|
78
|
+
In Claude Desktop, you can ask Claude to visually search your assets using the `search_assets_visual` tool. This opens an interactive gallery directly in the chat with:
|
|
79
|
+
|
|
80
|
+
- **Thumbnail grid** — browse search results visually with hover previews
|
|
81
|
+
- **Asset detail panel** — click any asset to view a full preview with file info, EXIF/IPTC metadata, and tags
|
|
82
|
+
- **Inline editing** — edit title, description, alt text, caption, credit, and copyright without leaving Claude
|
|
83
|
+
- **Ratings** — rate assets with a star rating
|
|
84
|
+
- **Tagging** — add and remove tags from assets
|
|
85
|
+
- **Downloads** — download assets in multiple sizes (small, medium, full, original) with optional watermarking
|
|
86
|
+
- **Bulk downloads** — select multiple assets and download them at once
|
|
87
|
+
- **Pagination** — navigate through large result sets
|
|
88
|
+
|
|
89
|
+
Try asking Claude: *"Visually show me all images tagged 'landscape'"*
|
|
90
|
+
|
|
64
91
|
## Available Tools
|
|
65
92
|
|
|
66
93
|
| Tool | Description |
|
|
67
94
|
|------|-------------|
|
|
68
95
|
| `whoami` | Get current user and organization info |
|
|
69
96
|
| `search_assets` | Search assets with filters (tags, dates, ratings, etc.) |
|
|
97
|
+
| `search_assets_visual` | Search assets and display results in an interactive visual gallery |
|
|
70
98
|
| `get_asset` | Get detailed asset information |
|
|
71
99
|
| `update_asset` | Update asset metadata (title, description, etc.) |
|
|
72
100
|
| `add_tags` | Add tags to an asset |
|