dank-meme-sounds 0.3.0 → 0.3.1
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/LICENSE +21 -0
- package/README.md +110 -20
- package/index.mjs +1 -1
- package/package.json +17 -5
- package/server.json +28 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 DankMachine
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,24 +1,49 @@
|
|
|
1
1
|
# dank-meme-sounds
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**A meme soundboard for AI agents.** Give Claude, Cursor, Codex, ChatGPT or any MCP client instant access to **38,000+ meme sound effects** from [DankMachine](https://dankmachine.com): vine boom, bruh, sad violin, airhorn, Windows XP error, anime wow, and every reaction sound the internet runs on.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Your agent can **find the right sound for a moment** ("my code finally compiled", "awkward silence", "someone got roasted"), search by name, mood or use case, see what's trending right now, and **play it out loud** on your speakers.
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/dank-meme-sounds)
|
|
8
|
+
[](https://dankmachine.com/developers/)
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
|
|
11
|
+
- 🔊 38k+ sounds, each with an MP3 URL and a sound page; the most popular ones have their own pixel-art icon
|
|
12
|
+
- 🧠 Sounds come with AI-written metadata: what it is, **when to use it**, moods, use cases and alternate names
|
|
13
|
+
- 🎯 `find_reaction_sound`: describe the situation, get the fitting sounds
|
|
14
|
+
- 📈 Live trending from real plays on dankmachine.com (1h / 24h / 7d)
|
|
15
|
+
- ▶️ `play_sound` plays it locally (macOS, Windows, Linux) — great for coding-agent hooks
|
|
16
|
+
- 🌐 Zero setup remote server, or a tiny local npm package. No API key.
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Quick start
|
|
21
|
+
|
|
22
|
+
### Remote server (no install)
|
|
6
23
|
|
|
7
24
|
```bash
|
|
8
25
|
claude mcp add --transport http dank-meme-sounds https://dankmachine.com/mcp
|
|
9
26
|
```
|
|
10
27
|
|
|
11
|
-
Any
|
|
28
|
+
Any client that supports Streamable HTTP:
|
|
29
|
+
|
|
30
|
+
```json
|
|
31
|
+
{
|
|
32
|
+
"mcpServers": {
|
|
33
|
+
"dank-meme-sounds": { "url": "https://dankmachine.com/mcp" }
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
```
|
|
12
37
|
|
|
13
|
-
|
|
38
|
+
### Local server (adds `play_sound` on your speakers)
|
|
14
39
|
|
|
15
|
-
Claude Code
|
|
40
|
+
**Claude Code**
|
|
16
41
|
|
|
17
42
|
```bash
|
|
18
43
|
claude mcp add dankmachine -- npx -y dank-meme-sounds
|
|
19
44
|
```
|
|
20
45
|
|
|
21
|
-
|
|
46
|
+
**Claude Desktop / Cursor / Windsurf / Cline / Zed** (`mcpServers` config)
|
|
22
47
|
|
|
23
48
|
```json
|
|
24
49
|
{
|
|
@@ -28,25 +53,53 @@ Any MCP client (Claude Desktop, Cursor, …):
|
|
|
28
53
|
}
|
|
29
54
|
```
|
|
30
55
|
|
|
56
|
+
**VS Code** (`.vscode/mcp.json`)
|
|
57
|
+
|
|
58
|
+
```json
|
|
59
|
+
{
|
|
60
|
+
"servers": {
|
|
61
|
+
"dankmachine": { "type": "stdio", "command": "npx", "args": ["-y", "dank-meme-sounds"] }
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**OpenAI Codex CLI** (`~/.codex/config.toml`)
|
|
67
|
+
|
|
68
|
+
```toml
|
|
69
|
+
[mcp_servers.dankmachine]
|
|
70
|
+
command = "npx"
|
|
71
|
+
args = ["-y", "dank-meme-sounds"]
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Requires Node.js 20+.
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
31
78
|
## Tools
|
|
32
79
|
|
|
33
|
-
| Tool | What it does |
|
|
34
|
-
| --- | --- |
|
|
35
|
-
| `find_reaction_sound` | Describe a moment
|
|
36
|
-
| `get_trending_sounds` | What people are playing right now (1h
|
|
37
|
-
| `search_sounds` | Search by title, tags, category or vibe |
|
|
38
|
-
| `random_sound` | Random sound, optionally by category or vibe |
|
|
39
|
-
| `get_sound` | One sound by slug or best match |
|
|
40
|
-
| `list_categories` |
|
|
41
|
-
| `play_sound` | Plays the sound on your speakers (afplay, Windows MediaPlayer, mpg123/ffplay/paplay) |
|
|
80
|
+
| Tool | What it does | Example |
|
|
81
|
+
| --- | --- | --- |
|
|
82
|
+
| `find_reaction_sound` | Describe a moment, get the best-fitting sounds with what each means and when to use it | "my build failed again" → sad trombone, bruh, windows error |
|
|
83
|
+
| `get_trending_sounds` | What people are playing on DankMachine right now (`1h`, `24h`, `7d`) | "what's trending today?" |
|
|
84
|
+
| `search_sounds` | Search by title, tags, category or vibe | "vine boom", "minecraft", "anime" |
|
|
85
|
+
| `random_sound` | Random sound, optionally by category or vibe (funny, hype, cursed, wholesome, scary, sad, epic, dramatic…) | "random cursed sound" |
|
|
86
|
+
| `get_sound` | One sound by slug or best match | `vine-boom-sound-70972` |
|
|
87
|
+
| `list_categories` | All categories with counts (memes, gaming, reactions, anime, brainrot, tiktok…) | |
|
|
88
|
+
| `play_sound` | **Local only.** Plays the sound on your speakers (afplay, Windows MediaPlayer, mpg123/ffplay/paplay) | "play an airhorn when tests pass" |
|
|
89
|
+
|
|
90
|
+
Every result includes the title, category, tags, an `audio` MP3 URL, a pixel-art `image` when available, and the `page` on dankmachine.com.
|
|
42
91
|
|
|
43
|
-
|
|
92
|
+
### Prompts to try
|
|
44
93
|
|
|
45
|
-
|
|
94
|
+
- *"Play vine boom when the tests pass and sad violin when they fail."*
|
|
95
|
+
- *"Find me a sound for a dramatic reveal in my video."*
|
|
96
|
+
- *"What are the top 5 trending meme sounds today?"*
|
|
97
|
+
- *"Give me three hype sounds for my stream intro, with links."*
|
|
98
|
+
- *"Pick a random cursed sound and play it."*
|
|
46
99
|
|
|
47
|
-
|
|
100
|
+
---
|
|
48
101
|
|
|
49
|
-
##
|
|
102
|
+
## Sound effects for your coding agent (Claude Code hooks)
|
|
50
103
|
|
|
51
104
|
`npx dank-meme-sounds play "<query>"` plays a sound from the terminal, so hooks can use it. Add to `~/.claude/settings.json`:
|
|
52
105
|
|
|
@@ -60,4 +113,41 @@ Try: *"play vine boom when the tests pass"*, *"find me a sad trombone"*, *"rando
|
|
|
60
113
|
}
|
|
61
114
|
```
|
|
62
115
|
|
|
63
|
-
Sounds are cached in your temp folder after the first play.
|
|
116
|
+
Sounds are cached in your temp folder after the first play, and the CLI never fails a hook (it exits 0 when offline).
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## REST API
|
|
121
|
+
|
|
122
|
+
The same catalog is a free JSON API with CORS, no key:
|
|
123
|
+
|
|
124
|
+
```
|
|
125
|
+
GET https://dankmachine.com/api/v1/search?q=vine%20boom&limit=5
|
|
126
|
+
GET https://dankmachine.com/api/v1/reaction?situation=my%20code%20compiled
|
|
127
|
+
GET https://dankmachine.com/api/v1/trending?window=24h
|
|
128
|
+
GET https://dankmachine.com/api/v1/sounds/<slug>
|
|
129
|
+
GET https://dankmachine.com/api/v1/sounds.json (full catalog)
|
|
130
|
+
GET https://dankmachine.com/api/v1/categories.json
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Docs: https://dankmachine.com/developers/
|
|
134
|
+
|
|
135
|
+
## Configuration
|
|
136
|
+
|
|
137
|
+
| Env var | Default | Purpose |
|
|
138
|
+
| --- | --- | --- |
|
|
139
|
+
| `DANKMACHINE_API` | `https://dankmachine.com/api/v1` | Point the local server at another catalog |
|
|
140
|
+
|
|
141
|
+
## More from DankMachine
|
|
142
|
+
|
|
143
|
+
- **Live sound chat**: https://dankmachine.com/rooms/ — IRC-style chat where every sound plays for everyone
|
|
144
|
+
- **OBS overlay** for streamers: https://dankmachine.com/obs/?r=lobby
|
|
145
|
+
- **Upload your own sounds**: https://dankmachine.com/upload/
|
|
146
|
+
|
|
147
|
+
## Content and rights
|
|
148
|
+
|
|
149
|
+
Sounds are user-contributed meme clips; `rights_status` is `unverified`. Removal requests: https://dankmachine.com/takedown/
|
|
150
|
+
|
|
151
|
+
## License
|
|
152
|
+
|
|
153
|
+
MIT for this server's code. Sounds belong to their respective owners.
|
package/index.mjs
CHANGED
|
@@ -74,7 +74,7 @@ if (process.argv[2] === 'play') {
|
|
|
74
74
|
process.exit(0);
|
|
75
75
|
}
|
|
76
76
|
|
|
77
|
-
const server = new McpServer({ name: 'dank-meme-sounds', version: '0.3.
|
|
77
|
+
const server = new McpServer({ name: 'dank-meme-sounds', version: '0.3.1' });
|
|
78
78
|
|
|
79
79
|
async function apiJson(p) {
|
|
80
80
|
const r = await fetch(`${API}${p}`);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dank-meme-sounds",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.1",
|
|
4
4
|
"description": "MCP server for DankMachine meme sounds: search, find reaction sounds for any moment, trending, and play them on your speakers. Remote version: https://dankmachine.com/mcp",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -10,7 +10,9 @@
|
|
|
10
10
|
"files": [
|
|
11
11
|
"index.mjs",
|
|
12
12
|
"play.mjs",
|
|
13
|
-
"README.md"
|
|
13
|
+
"README.md",
|
|
14
|
+
"LICENSE",
|
|
15
|
+
"server.json"
|
|
14
16
|
],
|
|
15
17
|
"engines": {
|
|
16
18
|
"node": ">=20"
|
|
@@ -21,7 +23,15 @@
|
|
|
21
23
|
"meme",
|
|
22
24
|
"soundboard",
|
|
23
25
|
"sound effects",
|
|
24
|
-
"claude"
|
|
26
|
+
"claude",
|
|
27
|
+
"mcp-server",
|
|
28
|
+
"sound-effects",
|
|
29
|
+
"memes",
|
|
30
|
+
"reaction",
|
|
31
|
+
"claude-code",
|
|
32
|
+
"hooks",
|
|
33
|
+
"cursor",
|
|
34
|
+
"ai-agents"
|
|
25
35
|
],
|
|
26
36
|
"homepage": "https://dankmachine.com",
|
|
27
37
|
"license": "MIT",
|
|
@@ -32,7 +42,9 @@
|
|
|
32
42
|
"mcpName": "io.github.TanKucukhas/dank-meme-sounds",
|
|
33
43
|
"repository": {
|
|
34
44
|
"type": "git",
|
|
35
|
-
"url": "git+https://github.com/TanKucukhas/
|
|
36
|
-
|
|
45
|
+
"url": "git+https://github.com/TanKucukhas/dank-meme-sounds.git"
|
|
46
|
+
},
|
|
47
|
+
"bugs": {
|
|
48
|
+
"url": "https://github.com/TanKucukhas/dank-meme-sounds/issues"
|
|
37
49
|
}
|
|
38
50
|
}
|
package/server.json
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
|
+
"name": "io.github.TanKucukhas/dank-meme-sounds",
|
|
4
|
+
"title": "DankMachine meme sounds",
|
|
5
|
+
"description": "Meme soundboard for AI agents: 38k meme sounds. Find reaction sounds, search, trending, play.",
|
|
6
|
+
"version": "0.3.1",
|
|
7
|
+
"websiteUrl": "https://dankmachine.com/developers/",
|
|
8
|
+
"repository": {
|
|
9
|
+
"url": "https://github.com/TanKucukhas/dank-meme-sounds",
|
|
10
|
+
"source": "github"
|
|
11
|
+
},
|
|
12
|
+
"packages": [
|
|
13
|
+
{
|
|
14
|
+
"registryType": "npm",
|
|
15
|
+
"identifier": "dank-meme-sounds",
|
|
16
|
+
"version": "0.3.1",
|
|
17
|
+
"transport": {
|
|
18
|
+
"type": "stdio"
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
],
|
|
22
|
+
"remotes": [
|
|
23
|
+
{
|
|
24
|
+
"type": "streamable-http",
|
|
25
|
+
"url": "https://dankmachine.com/mcp"
|
|
26
|
+
}
|
|
27
|
+
]
|
|
28
|
+
}
|