Freesound MCP Server

Freesound MCP服务器

一个MCP（模型上下文协议）服务器，提供对Freesoundneneneba API的访问，使人工智能助手能够从Freesound.org搜索、分析和检索有关音频样本的信息。

先决条件

• Node.js 16或更高版本
• Freesound API密钥（在https://freesound.org/apiv2/apply)

安装

1. 克隆此存储库：

git clone 
cd freesound-mcp-server

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

Claude Code快速入门

全球安装（所有项目）

1. 从获取您的Freesound API密钥https://freesound.org/apiv2/apply

1. 添加到克劳德代码：

# From the freesound-mcp-server directory (user scope for global access)
claude mcp add freesound -e FREESOUND_API_KEY=your-api-key-here -- node /path/to/freesound-mcp-server/dist/index.js

验证安装

要检查MCP服务器是否正确配置和运行，请使用 /mcp 克劳德代码中的命令：

claude
> /mcp

这将显示所有配置的MCP服务器的状态。

使用Claude Desktop

将以下内容添加到您的Claude Desktop配置文件中：

macOS

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

视窗

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "freesound": {
      "command": "node",
      "args": ["/path/to/freesound-mcp-server/dist/index.js"],
      "env": {
        "FREESOUND_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

搜索_声音

使用文本查询在Freesound上搜索声音。

参数：

• query （必填）：搜索查询词
• filter：使用Solr语法进行筛选（例如，“持续时间：\[1到5\]”）
• sort：按各种标准对结果进行排序
• page：页码（默认值：1）
• page_size：每页结果数（默认值：15，最大值：150）

例子：

Search for: "piano jazz" with filter "duration:[5 TO 30]" sorted by "downloads_desc"

get_sound

获取特定声音的详细信息。

参数：

• sound_id （必填）：声音的ID
• descriptors：要包含的以逗号分隔的内容描述符列表

get_sound_analysis

检索声音的音频分析数据。

参数：

• sound_id （必填）：声音的ID
• descriptors：要检索的特定分析描述符
• normalized：是否规范化描述符值

get_similar_sounds

查找与给定声音相似的声音。

参数：

• sound_id （必填）：参考声音的ID
• descriptors_filter：按内容描述符筛选
• page：页码
• page_size：每页结果

get_user

获取Freesound用户的信息。

参数：

• username （必填）：用户名

get_user_sounds

获取特定用户上传的声音。

参数：

• username （必填）：用户名
• page：页码
• page_size：每页结果

get_pack

获取有关声音包的信息。

参数：

• pack_id （必填）：包的ID

get_back_sounds

从特定包中获取声音。

参数：

• pack_id （必填）：包的ID
• page：页码
• page_size：每页结果

发展

在开发模式下运行服务器：

npm run dev

API限制

• 令牌身份验证用于大多数端点
• 下载声音和写入操作需要OAuth2（此版本中未实现）
• 根据您的Freesound API计划适用价格限制
• 最大页面大小为150个结果

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。

支持

有关Freesound API的问题，请参阅：

• Freesound API文档：https://freesound.org/docs/api/
• 自由声音API论坛：https://freesound.org/forum/

有关此MCP服务器的问题，请在GitHub上打开问题。