myinstants

🔴 myinstants-mcp

给你的 AI Agent 配一个音效板。绝不骗人。
_{数百万个音效按钮 · 零配置 · 只有乐趣 ✨}

快速开始：

---

说真的，这是什么

一个 MCP 服务，可将 AI Agent 连接到 myinstants.com——互联网上最大的音效板。数百万个梗音效、Vine Boom、放屁声、动漫片段、游戏音效，想要什么都有，朋友。

现在，你的 AI Agent 可以：

• 🔍 搜索 myinstants 上的任意音效
• 🔴 猛按按钮，通过扬声器播放音效
• 📂 浏览分类——梗、游戏、电影、反应、TikTok 热门趋势
• 📈 查看热门内容——紧跟潮流
• ⏳ 等待或不等待——阻塞至音效播放完毕，或让它在后台播放

这可不是通知提示音，而是整个互联网的音效板。你的 Agent 现在也很有魅力了。

设置简单得很

npx myinstants-mcp

就这样。设置就是这么简单，绝不骗人。

VS Code / GitHub Copilot

添加到你的 VS Code MCP 配置中（用户配置或 .vscode/mcp.json）：

{
  "servers": {
    "myinstants": {
      "command": "npx",
      "args": ["-y", "myinstants-mcp@latest"]
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "myinstants": {
      "command": "npx",
      "args": ["-y", "myinstants-mcp@latest"]
    }
  }
}

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "myinstants": {
      "command": "npx",
      "args": ["-y", "myinstants-mcp@latest"]
    }
  }
}

提示

在 macOS 上开箱即用（使用原生 afplay）——无需额外安装。在 Linux 上只需运行 sudo apt install ffmpeg。就这么简单，朋友。

---

不过它能做什么呢 🤔

🔧 工具

工具	功能	示例
search_sounds	搜索 myinstants 中的音效	"bruh" → 返回 20 条带有 slug 的结果
browse_category	按类别浏览	"memes" "games" "reactions"
play_sound	播放音效（通过 slug、URL 或快速搜索）	{ query: "sad trombone" } 会立即播放
get_sound_details*	获取音效详情（播放量、上传者、时长）	需要 MYINSTANTS_DETAILS=true
list_devices*	列出可用的音频输出设备	需要 MYINSTANTS_DETAILS=true

_{* 需要设置环境变量 MYINSTANTS_DETAILS=true}

play_sound 选项

参数	类型	默认值	说明 ☕
query	string	—	快速搜索并播放首个结果。绝佳选择。
slug	string	—	搜索结果中的确切 slug
url	string	—	直接 MP3 URL，适合特立独行的你
wait	boolean	false	false = 在后台播放，Agent 继续工作（默认 💨）。true = 阻塞直到播放完成（营造戏剧效果 🎭）

📚 资源

资源	风格
myinstants://trending	美国当前最热门的内容 🔥
myinstants://categories	全部 14 个类别，一个不落
myinstants://best	名人堂。顶尖之选。传奇。🐐

类别

anime & manga · games · memes · movies · music · politics · pranks · reactions · sound effects · sports · television · tiktok trends · viral · whatsapp audios

工作原理（写给酷炫的开发者）

agent calls play_sound({ query: "vine boom", wait: false })
  → searches myinstants.com
  → finds the MP3 URL
  → streams it through afplay/ffplay/mpv
  → sound plays through your speakers
  → agent keeps cooking while you hear the boom 🍳

音效会自动排队播放，不会重叠。你的 Agent 可以连续触发多个音效，它们会依次播放。绝了。

教你的 Agent 恶搞你 💀

在仓库中放入一个 .instructions.md 文件（并在 frontmatter 中添加 applyTo: "**"），这样 Agent 就会在工作时播放音效。想象一下：发现 bug 时响起 vine boom，测试失败时响起悲伤的长号，代码审查到一半时毫无理由地播放 Rickroll。

---
name: "Soundboard"
description: "Sounds for all contexts"
applyTo: "**"
---

Play sounds using the myinstants MCP server while you work:
- Play `play_sound(query: "vine boom sound")` when you find cursed code
- Play `play_sound(query: "sad trombone")` when the user's code doesn't work
- Play `play_sound(query: "minecraft level up sound")` when you fix something

查看我们的 myinstants.instructions.md，了解完整又疯狂的配置。你的 Agent 再也不会是个路人了。🏆

配置

环境变量

变量	默认值	说明 ☕
MYINSTANTS_VOLUME	0.5	音量大小（0-1）。把音量调到最大吧，伙计。
MYINSTANTS_WAIT	false	"true" = 阻塞直到音效播放完毕。戏剧效果模式 🎭
MYINSTANTS_DEVICE	(system default)	将音频输出到指定设备。设备名称因平台而异。
MYINSTANTS_PLAYER	(auto)	指定播放器：ffplay、mpv、afplay 或 paplay。
MYINSTANTS_DETAILS	false	"true" = 启用 get_sound_details 和 list_devices 工具。

{
  "servers": {
    "myinstants": {
      "command": "npx",
      "args": ["-y", "myinstants-mcp@latest"],
      "env": {
        "MYINSTANTS_VOLUME": "0.8",
        "MYINSTANTS_DEVICE": "Denon AVR-S760H",
        "MYINSTANTS_DETAILS": "true"
      }
    }
  }
}

音频设备选择

将音效输出到指定设备，而不是系统默认设备：

# set device name (platform-specific)
export MYINSTANTS_DEVICE="Denon AVR-S760H"

# force a specific player (optional)
export MYINSTANTS_PLAYER="ffplay"

# enable device listing tool
export MYINSTANTS_DETAILS="true"

发现可用设备：

# macOS
ffmpeg -f avfoundation -list_devices true -i "" 2>&1

# Linux (PulseAudio)
pactl list short sinks

# mpv (cross-platform)
mpv --audio-device=help

或者在 MYINSTANTS_DETAILS=true 时使用 list_devices 工具——让你的 Agent 帮你发现设备。💅

播放器支持：

播放器	设备标志	示例
ffplay	-audio_device	ffplay -audio_device "Denon AVR-S760H"
mpv	--audio-device=	mpv --audio-device="pulse/alsa_output.usb"
paplay	--device=	paplay --device=bluez_sink.XX
afplay	❌ 不适用	仅使用 macOS 系统默认设备（不支持选择设备）

注意：

• 默认行为不变——如果未设置 MYINSTANTS_DEVICE，则使用系统默认输出设备
• macOS 上的 afplay 不支持选择设备——如果需要控制设备，请设置 MYINSTANTS_PLAYER=ffplay 或 mpv
• 设备名称因平台而异（参见上方的发现设备命令）
• Windows PowerShell 播放器不支持选择设备——安装 ffmpeg 或 mpv 以支持选择设备

音频播放器支持

播放器	平台	安装	风格
afplay	macOS	预装 💅	开箱即用，毫不费力，绝绝子。
ffplay	所有平台	brew install ffmpeg / apt install ffmpeg	可靠的好搭档
mpv	所有平台	brew install mpv / apt install mpv	也完全没问题，真的

会自动检测你安装了哪些播放器。在 macOS 上优先尝试 afplay，然后是 ffplay，最后是 mpv。这个兜底链路真不错。

为什么嘛 💀

因为代码编译成功时，你的 AI Agent 就该给你来一段 vine boom 音效。因为测试失败时响起悲伤长号，客观来说完全正确。因为 bruh 按钮就在那里，你的 Agent 值得按下它。这可不是妄想——这就是未来。

其他所有 MCP 音效服务都只会播放一声通知提示音。**一声。**简直一股 NPC 味。我们有数百万种音效，整个互联网的音效板，只有主角才有这种待遇。

开源味儿十足 💅

由 @austenstone 制作 🏷️

由 myinstants.com 提供支持 · 使用 MCP 构建

说真的，这可能是史上最放飞自我的 MCP 服务，我们甚至有点暗自骄傲 💀🔥