@olaservo/scryfall-mcp-server 1.0.0 → 1.0.2
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 +27 -5
- package/dist/card-viewer.html +49 -32
- package/dist/index.d.ts +1 -0
- package/dist/index.js +24 -24
- package/dist/server.d.ts +2 -0
- package/dist/server.js +18 -0
- package/dist/transports/stdio.d.ts +1 -0
- package/dist/transports/stdio.js +10 -0
- package/dist/transports/streamableHttp.d.ts +1 -0
- package/dist/transports/streamableHttp.js +70 -0
- package/package.json +8 -2
package/README.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# Scryfall MCP Server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A community MCP server for searching and fetching Magic: The Gathering card data from [Scryfall](https://scryfall.com). Features an [MCP App](https://github.com/modelcontextprotocol/ext-apps) UI that renders card images, mana symbols, oracle text, and pricing when used in compatible hosts like Claude Desktop.
|
|
4
|
+
|
|
5
|
+
> **Note:** This is an independent community project. It is not affiliated with or endorsed by Scryfall.
|
|
4
6
|
|
|
5
7
|
|
|
6
8
|
|
|
@@ -9,16 +11,35 @@ An MCP server for searching and fetching Magic: The Gathering card data from [Sc
|
|
|
9
11
|
- **search** — Search for cards using [Scryfall full-text syntax](https://scryfall.com/docs/syntax) (e.g., `c:red t:creature cmc=3`, `set:mkm`, `o:"draw a card"`)
|
|
10
12
|
- **fetch** — Fetch full card details by Scryfall UUID. In MCP App-capable hosts, renders a card viewer UI with the card image, mana cost icons, oracle text, set info, rarity, and prices.
|
|
11
13
|
|
|
12
|
-
##
|
|
14
|
+
## Installation
|
|
15
|
+
|
|
16
|
+
### Option 1: MCPB (one-click install for Claude Desktop)
|
|
17
|
+
|
|
18
|
+
Download [`scryfall-mcp-server.mcpb`](https://github.com/olaservo/scryfall-mcp-app/releases/latest) from the latest release and open it in Claude Desktop.
|
|
19
|
+
|
|
20
|
+
### Option 2: npm
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"mcpServers": {
|
|
25
|
+
"scryfall": {
|
|
26
|
+
"command": "npx",
|
|
27
|
+
"args": ["-y", "@olaservo/scryfall-mcp-server"]
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### Option 3: Build from source
|
|
13
34
|
|
|
14
35
|
```bash
|
|
36
|
+
git clone https://github.com/olaservo/scryfall-mcp-app.git
|
|
37
|
+
cd scryfall-mcp-app
|
|
15
38
|
npm install
|
|
16
39
|
npm run build
|
|
17
40
|
```
|
|
18
41
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
Add to your `claude_desktop_config.json`:
|
|
42
|
+
Then add to your `claude_desktop_config.json`:
|
|
22
43
|
|
|
23
44
|
```json
|
|
24
45
|
{
|
|
@@ -37,6 +58,7 @@ Add to your `claude_desktop_config.json`:
|
|
|
37
58
|
npm run dev # Watch mode with tsx
|
|
38
59
|
npm run build # Build UI + server
|
|
39
60
|
npm run inspector # Test with MCP Inspector
|
|
61
|
+
npm run pack # Build .mcpb bundle
|
|
40
62
|
```
|
|
41
63
|
|
|
42
64
|
## How It Works
|