音频存档搜索服务

MCP Internet Archive 是一个提供AI助手搜索和下载互联网档案馆(archive.org)中公共领域和知识共享许可音频内容的服务。

  • by palanquin-software
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 palanquin-software/mcp-internet-archive

使用说明


MCP Internet Archive

[![Project license](https://img.shields.io/github/license/palanquin-software/mcp-internet-archive.svg?style=flat-square)](LICENSE) [![Made by Palanquin Software](https://img.shields.io/badge/made%20by-Palanquin%20Software-blue?style=flat-square)](https://github.com/palanquin-software)
Table of Contents

关于

MCP Internet Archive是一个模型上下文协议(MCP)服务器,为AI助手提供搜索和 从互联网档案馆(Archive.org)下载公共领域和知识共享许可的音频内容。

该服务器使AI系统能够:

  • 搜索庞大的互联网档案音频收藏
  • 检索有关音频项目的详细元数据
  • 通过智能格式选择下载音频文件
  • 自动检测和连接多部分音频文件

该项目旨在使互联网档案馆的公共领域音频内容宝库易于访问 AI助手,使他们能够帮助用户发现和检索历史记录、广播、音乐和 其他音频材料。

构建于

入门指南

先决条件

  • 转到1.25.2或更高版本
  • FFmpeg(可选,用于多部分文件拼接)

安装

使用mise:

git clone https://github.com/palanquin-software/mcp-internet-archive.git
cd mcp-internet-archive
make install

手动安装:

git clone https://github.com/palanquin-software/mcp-internet-archive.git
cd mcp-internet-archive
cd cmd/mcp
go build -o ~/bin/mcp-internet-archive
chmod +x ~/bin/mcp-internet-archive

配置您的MCP客户端:

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
  "mcpServers": {
    "internet-archive": {
      "command": "/Users/YOUR_USERNAME/bin/mcp-internet-archive",
      "env": {
        "IA_MAX_RESULTS": "10",
        "IA_DOWNLOAD_DIR": "/Users/YOUR_USERNAME/Downloads",
        "IA_FFMPEG": "ffmpeg",
        "IA_CONCAT_ASK_THRESH": "5"
      }
    }
  }
}

用法

配置后,MCP服务器为您的AI助手提供三个工具:

搜索_音频

在Internet存档中搜索音频内容:

Search for "jazz recordings 1920s"

助理将使用 search_audio 用于查找匹配的公共域音频项目的工具。

获取元数据

获取特定存档项目的详细信息:

Get metadata for archive item "Greatest_Speeches_of_the_Century"

返回全面的元数据,包括所有可用的音频文件及其格式。

下载_音频

下载具有智能格式选择和可选拼接功能的音频文件:

Download audio from "Complete_Broadcast_Day_D-Day"

多部分文件处理:

服务器自动检测多部分文件(例如。, Part_001.mp3, Part_002.mp3等等)。如果有5个或更多零件 如果检测到,它将建议连接:

Download audio from "Complete_Broadcast_Day_D-Day" with concat=true

这将下载所有部分,使用ffmpeg将它们连接到一个文件中,并清理各个部分。

环境变量

变量 描述 默认值
IA_S3_ACCESS_KEY Internet Archive S3访问密钥 (无)
IA_S3_SECRET_KEY Internet Archive S3密钥 (无)
IA_MAX_RESULTS 返回的最大搜索结果数 10
IA_DOWNLOAD_DIR 下载文件目录 ~/Downloads
IA_FFMPEG ffmpeg二进制文件的路径 ffmpeg
IA_CONCAT_ASK_THRESH 建议拼接的最小部件 5

路线图

计划的功能

  • 扩展到音频之外:支持视频、文本和图像收藏
  • 高级搜索过滤器:日期范围、创建者筛选、收藏浏览
  • 播放列表支持:下载整个播放列表或收藏
  • 流媒体支持:直接流式传输音频,无需下载
  • 格式转换:内置音频格式转换(例如FLAC→ MP3)
  • 进度报告:大文件的实时下载进度
  • 批量操作:在一次操作中下载多个项目
  • 缓存管理:智能磁盘使用和清理

贡献

欢迎投稿!需要帮助的领域:

  • 使用各种archive.org集合进行测试
  • 支持其他媒体类型
  • 针对大下载量的性能优化
  • 文档改进

许可证

该项目根据 MIT许可证.

看 许可证 了解更多信息。