MCP Internet Archive

MCP Internet Archive

 

Table of Contents

• 关于

- 构建于

• 入门指南

- 先决条件 - 安装

• 用法
• 路线图
• 许可证

______________________________________________________________________

关于

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

该服务器使AI系统能够：

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

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

构建于

• 转到1.25.2 -主要语言
• 模型上下文协议SDK -MCP服务器实现
• 休息 -Archive.org API的HTTP客户端
• caarlos0/env -环境变量配置
• FFmpeg -音频文件拼接（可选）

入门指南

先决条件

• 转到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将它们连接到一个文件中，并清理各个部分。

环境变量

路线图

计划的功能

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

贡献

欢迎投稿！需要帮助的领域：

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

许可证

该项目根据 MIT许可证.

看 许可证 了解更多信息。