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 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
- Give your AI agent a meme soundboard. Search, fetch and **play** 1,500+ meme sound buttons from [DankMachine](https://dankmachine.com), each with its own pixel-art icon.
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
- ## Remote server (no install)
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
+ [![npm](https://img.shields.io/npm/v/dank-meme-sounds)](https://www.npmjs.com/package/dank-meme-sounds)
8
+ [![MCP](https://img.shields.io/badge/MCP-remote%20%2B%20stdio-ff3db0)](https://dankmachine.com/developers/)
9
+ [![License: MIT](https://img.shields.io/badge/license-MIT-green)](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 MCP client: `{ "mcpServers": { "dank-meme-sounds": { "url": "https://dankmachine.com/mcp" } } }`. Docs: https://dankmachine.com/developers/
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
- ## Local install (adds `play_sound` on your speakers)
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
- Any MCP client (Claude Desktop, Cursor, …):
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 ("my code finally compiled") and get fitting sounds with what they mean |
36
- | `get_trending_sounds` | What people are playing right now (1h, 24h, 7d) |
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` | Categories with counts |
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
- Try: *"play vine boom when the tests pass"*, *"find me a sad trombone"*, *"random cursed sound"*.
92
+ ### Prompts to try
44
93
 
45
- ## Config
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
- `DANKMACHINE_API` points at another catalog (default `https://dankmachine.com/api/v1`).
100
+ ---
48
101
 
49
- ## Claude Code hooks (sound effects for your agent)
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.0' });
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.0",
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/dankmachine.git",
36
- "directory": "packages/mcp"
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
+ }