音频资源搜索下载服务

自由声音MCP

模型上下文协议（MCP）服务器，使AI应用程序能够从 自由之声 平台通过自然语言命令。

概述

Freesound MCP旨在简化将无版权的声音资源集成到AI工具中的过程。它遵循模型上下文协议标准，并通过stdin/stdout与主机应用程序通信。服务器提供两个主要功能：

• 🔍 搜索声音：使用可选过滤器按关键字搜索声音，以获得最长持续时间和许可证类型
• ⬇️ 下载声音：从Freesound按声音ID下载音频文件
• 🎵 元数据支持：检索有关声音的详细信息，包括持续时间、许可证和预览链接

特性

• 使用Node.js构建的轻量级MCP服务器
• 符合MCP协议的标准输入/输出通信机制
• 通过环境变量确保API密钥管理的安全性
• 无需数据库-简单、无状态的设计

先决条件

• Node.js（支持CommonJS模块）
• npm或yarn包管理器
• Freesound API密钥（在 Freesound API页面)

安装

1. 克隆存储库：

git clone https://github.com/yourusername/freesound-mcp.git
cd freesound-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

设置

1. 从获取您的Freesound API密钥 Freesound API页面

2. 将API密钥设置为环境变量：

export FREESOUND_API_KEY=your_freesound_api_key_here

Claude桌面中的配置

要在Claude Desktop中配置此MCP服务器，请执行以下操作：

1. 打开克劳德桌面首选项
2. 导航到“Beta功能”→ “模型上下文协议（MCP）工具”
3. 点击“配置”以管理MCP服务器
4. 添加具有以下详细信息的新服务器配置：
   • 名称：“Freesound MCP”
   • 命令： node
   • 论据： /path/to/freesound-mcp/dist/index.js （跑步后 npm run build)
   • 环境变量：确保 FREESOUND_API_KEY 可用于该进程
5. 保存配置并重新启动Claude

重启Claude后，您将能够在对话中使用Freesound工具。

用法

在Claude中配置后，您可以使用自然语言命令，例如：

• “在30秒内为我找到一个雨林环境声音”
• “下载声音#123456为高质量”

可用工具

1.自由搜索(freesound_search)

通过提供关键字和可选过滤器在Freesound上搜索声音。

参数：

• query （必填）：搜索关键字
• maxDuration （可选）：声音的最大持续时间（秒）
• license （可选）：要搜索的声音的许可证类型

退货：

• 声音对象数组，包含：
  • id：声音ID
  • name：声音名称
  • duration：声音持续时间（秒）
  • license：声音许可证
  • preview：声音预览URL

2.免费下载(freesound_download)

通过声音ID从Freesound下载声音。

参数：

• soundId （必填）：要下载的声音的ID
• quality （可选）：音频质量（'hq'表示高质量，'lq'表示低质量），默认为'lq]
• downloadDir （可选）：自定义下载目录，默认为~/.freesound mcp/downloads

退货：

• filePath：下载文件的路径

安全考虑

• 保持你的 FREESOUND_API_KEY 机密，永远不要在客户端代码中公开
• 对输入参数进行验证，以防止恶意ID传递到API
• 服务器遵循MCP通信安全最佳实践

贡献

欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• 多亏了 自由之声 用于提供音频资源API
• 使用 模型上下文协议SDK