Transistor MCP Server 使用说明

项目简介

Transistor MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在将 Transistor.fm 播客平台的功能集成到支持 MCP 协议的 LLM 应用中。它提供了一系列工具，允许用户通过 LLM 客户端管理播客节目、查看音频分析数据以及进行内容操作。

主要功能点

播客节目管理：支持列出、创建和更新 Transistor.fm 平台上的播客节目和剧集。
音频分析：提供播客和剧集的下载统计等分析数据查询功能。
Webhook 管理：允许订阅和取消订阅播客节目的 Webhook 事件，以便实时接收更新通知。
用户认证：提供获取已认证用户信息的功能。
音频上传授权：支持获取预签名 URL，用于安全上传音频文件。

安装步骤

前提条件：
- 安装 Node.js 和 npm (或 yarn)。
- 拥有 Transistor.fm 平台的 API 密钥。

下载仓库代码：

使用 Git 克隆仓库到本地：

git clone https://github.com/gxjansen/Transistor-MCP.git
cd Transistor-MCP

安装依赖：

npm install

或

yarn install

构建项目：

运行构建命令编译 TypeScript 代码：

npm run build

或

yarn build

服务器配置

要将 Transistor MCP Server 添加到 MCP 客户端，您需要在客户端的 MCP 服务器配置文件中添加以下 JSON 配置。请确保将 'your-api-key-here' 替换为您的 Transistor.fm API 密钥，并将 'path/to/Transistor-MCP/build/index.js' 替换为实际的项目 'build/index.js' 文件的路径。

{
  "mcpServers": {
    "transistor": {
      "command": "node",
      "args": ["path/to/Transistor-MCP/build/index.js"],
      "env": {
        "TRANSISTOR_API_KEY": "your-api-key-here"
      }
    }
  }
}

配置参数说明：

'server name'：'transistor' - 服务器名称，在 MCP 客户端中用于标识和调用此服务器。
'command'：'node' - 运行服务器的命令，这里使用 Node.js 运行时。
'args'：'["path/to/Transistor-MCP/build/index.js"]' - 启动服务器的参数，指向编译后的 'index.js' 文件路径。
'env'：'{"TRANSISTOR_API_KEY": "your-api-key-here"}' - 环境变量配置，必须填入您的 Transistor.fm API 密钥。

基本使用方法

配置完成后，在 MCP 客户端中，您可以使用 'use_mcp_tool' 等函数调用 Transistor MCP Server 提供的工具。以下是一些示例：

列出播客节目：

const shows = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "list_shows",
  arguments: {}
});
console.log(shows);

获取剧集详情：

const episodeDetails = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_episode",
  arguments: {
    episode_id: "your-episode-id" // 替换为实际的剧集 ID
  }
});
console.log(episodeDetails);

更多工具和参数：请参考仓库的 'README.md' 文件中 "Available Tools" 部分，了解每个工具的详细参数和使用方法。

注意：

使用前请确保已正确配置 Transistor.fm API 密钥。
API 请求受 Transistor.fm 速率限制，请注意控制请求频率。

关键词