使用说明

晶体管MCP服务器

此MCP服务器提供与晶体管.fm API，允许您管理播客、剧集和查看分析。

配置

使用Transistor API键将服务器添加到MCP设置配置文件中：

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

可用工具

get_authenticated_user

获取经过身份验证的用户帐户的详细信息。

{
  // No parameters needed
}

授权_地图

获取用于上传音频文件的预签名URL。在使用本地音频文件创建剧集之前，请使用此功能。

{
  "filename": string  // Required: Name of the audio file to upload
}

答复包括：

upload_url:用于上传文件的预签名S3 url
content_type：上传时使用的内容类型（例如，“audio/mpeg”）
expires_in：上传URL过期前的时间（秒）
audio_url:创建剧集时使用的最终url

list_shows

列出您Transistor.fm帐户中的所有节目，按更新日期排序（最新优先）。返回一个分页列表，每页包含10个项目。

{
  "page": number,     // Optional, defaults to 0 (first page)
  "per": number,      // Optional, defaults to 10 items per page
  "private": boolean, // Optional: filter for private shows
  "query": string     // Optional: search query
}

注意：所有参数都是可选的。不带参数调用此端点将返回显示的第一页。

list_episodes

列出特定节目的剧集。

{
  "show_id": string,  // Required
  "page": number,     // Optional, defaults to 0
  "per": number,      // Optional, defaults to 10
  "query": string,    // Optional: search query
  "status": string,   // Optional: "published", "draft", or "scheduled"
  "order": string     // Optional: "desc" (newest first) or "asc" (oldest first), defaults to "desc"
}

get_episode

获取特定剧集的详细信息。

{
  "episode_id": string,           // Required
  "include": string[],           // Optional: array of related resources to include
  "fields": {                    // Optional: sparse fieldsets
    "episode": string[],         // Fields to include for episode
    "show": string[]            // Fields to include for show
  }
}

get_analytics

获取某个节目或特定剧集的分析。如果未提供日期，则默认为过去14天。

{
  "show_id": string,            // Required
  "episode_id": string,         // Optional: include for episode-specific analytics
  "start_date": string,         // Optional: format "dd-mm-yyyy", required if end_date is provided
  "end_date": string           // Optional: format "dd-mm-yyyy", required if start_date is provided
}

创建路径

创建新剧集。

{
  "show_id": string,               // Required
  "title": string,                 // Required
  "audio_url": string,             // Required
  "summary": string,               // Optional
  "description": string,           // Optional: may contain HTML
  "transcript_text": string,       // Optional: full episode transcript
  "author": string,               // Optional
  "explicit": boolean,            // Optional
  "image_url": string,            // Optional: episode artwork
  "keywords": string,             // Optional: comma-separated list
  "number": number,               // Optional: episode number
  "season_number": number,        // Optional
  "type": string,                // Optional: "full", "trailer", or "bonus"
  "alternate_url": string,       // Optional: override share_url
  "video_url": string,           // Optional: YouTube URL
  "email_notifications": boolean, // Optional: override show setting
  "increment_number": boolean     // Optional: auto-set next episode number
}

update_episode

更新现有剧集。

{
  "episode_id": string,           // Required
  "title": string,               // Optional
  "summary": string,             // Optional
  "description": string,         // Optional: may contain HTML
  "transcript_text": string,     // Optional: full episode transcript
  "author": string,             // Optional
  "explicit": boolean,          // Optional
  "image_url": string,          // Optional: episode artwork
  "keywords": string,           // Optional: comma-separated list
  "number": number,             // Optional: episode number
  "season_number": number,      // Optional
  "type": string,              // Optional: "full", "trailer", or "bonus"
  "alternate_url": string,     // Optional: override share_url
  "video_url": string,         // Optional: YouTube URL
  "email_notifications": boolean // Optional: override show setting
}

get_all_episode_analytics

获取节目所有剧集的分析。如果未提供日期，则默认为过去7天。

{
  "show_id": string,            // Required
  "start_date": string,         // Optional: format "dd-mm-yyyy", required if end_date is provided
  "end_date": string           // Optional: format "dd-mm-yyyy", required if start_date is provided
}

list_webhooks

列出某个节目的所有Webhook。

{
  "show_id": string            // Required
}

subscribe_webhook

订阅webhook观看节目。

{
  "event_name": string,        // Required: e.g., "episode_created"
  "show_id": string,          // Required
  "url": string              // Required: URL to receive webhook events
}

取消订阅_webhook

取消订阅webhook。

{
  "webhook_id": string        // Required
}

get_show

按ID观看节目。

show_id: string   // Required

update_show

更新节目。

show_id: string   // Required
author: string   // Optional
category: string   // Optional
copyright: string   // Optional
description: string   // Optional
explicit: boolean   // Optional
image_url: string   // Optional
keywords: string   // Optional
language: string   // Optional
owner_email: string   // Optional
secondary_category: string   // Optional
show_type: "episodic" | "serial"   // Optional
title: string   // Optional
time_zone: string   // Optional
website: string   // Optional

publish_episode

在不编辑元数据的情况下发布或安排剧集。

episode_id: string   // Required
status: "published" | "scheduled" | "draft"   // Required
published_at: string   // Optional

get_download_summary

获取节目或剧集的计算下载摘要。返回总下载量、每日平均值、每周趋势和最佳/最差日期。

show_id: string   // Required
episode_id: string   // Optional
start_date: string   // Optional
end_date: string   // Optional

比较事件

按总下载量排序，比较多集的下载性能。

episode_ids: string[]   // Required - array of episode IDs
start_date: string   // Optional
end_date: string   // Optional

list_订阅者

列出节目的订阅者。

show_id: string   // Required
page: number   // Optional
per: number   // Optional
query: string   // Optional

get_subscriber

通过ID获取订阅者。

subscriber_id: string   // Required

创建者_订阅者

创建订阅者。

show_id: string   // Required
email: string   // Required
skip_welcome_email: boolean   // Optional

创建_订阅_批处理

在单个请求中创建多个订阅者。

show_id: string   // Required
emails: string[]   // Required
skip_welcome_email: boolean   // Optional

update_订阅者

更新订阅者的电子邮件。

subscriber_id: string   // Required
email: string   // Required

delete_订阅者

删除订阅者。提供其中之一 subscriber_id，或两者都有 show_id 和 email.

subscriber_id: string   // Optional - either this, or both show_id + email
show_id: string   // Optional - required with email when no subscriber_id
email: string   // Optional - required with show_id when no subscriber_id

重要说明

API请求的速率限制为每10秒10个请求（按照(https://developers.transistor.fm/#:~：text=neneneba API%20请求%20是%20速率%2D受限，%20再次使用%20API%20。)[晶体管API参考]）
日期接受ISO yyyy-mm-dd （推荐），并转换为晶体管API dd-mm-yyyy 自动； dd-mm-yyyy 也被接受
页码从0开始
所有端点支持：
- 稀疏字段集：使用指定要返回的字段 fields[resource_type][]
- 包括相关资源：使用 include[] 在单个请求中获取相关资源
包含数组使用以下格式 ["resource_name"]
字段对象指定每种资源类型返回哪些字段
所有工具都以JSONAPI格式返回具有适当关系和元数据的数据

示例用法

列表显示：

// List first page of shows (default behavior)
const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "list_shows",
  arguments: {}
});

// List shows with pagination and filtering
const resultWithParams = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "list_shows",
  arguments: {
    page: 1,
    per: 20,
    private: true,
    query: "podcast"
  }
});

获取剧集详细信息：

const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_episode",
  arguments: {
    episode_id: "123456",
    include: ["show"],
    fields: {
      episode: ["title", "summary", "description"],
      show: ["title"]
    }
  }
});

获取节目分析：

// Get analytics for the last 14 days (default behavior)
const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_analytics",
  arguments: {
    show_id: "123456"
  }
});

// Get analytics for a specific date range
const resultWithDates = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_analytics",
  arguments: {
    show_id: "123456",
    start_date: "01-01-2024",
    end_date: "31-01-2024"
  }
});

// Get analytics for a specific episode
const episodeAnalytics = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_analytics",
  arguments: {
    show_id: "123456",
    episode_id: "789012",
    start_date: "01-01-2024",
    end_date: "31-01-2024"
  }
});

更新剧集：

const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "update_episode",
  arguments: {
    episode_id: "123456",
    title: "Updated Episode Title",
    summary: "New episode summary",
    description: "New detailed description",
    season_number: 2,
    episode_number: 5
  }
});

获取所有剧集分析：

// Get analytics for all episodes for the last 7 days (default behavior)
const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_all_episode_analytics",
  arguments: {
    show_id: "123456"
  }
});

// Get analytics for all episodes for a specific date range
const resultWithDates = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_all_episode_analytics",
  arguments: {
    show_id: "123456",
    start_date: "01-01-2024",
    end_date: "31-01-2024"
  }
});

管理webhooks：

// List webhooks
const webhooks = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "list_webhooks",
  arguments: {
    show_id: "123456"
  }
});

// Subscribe to webhook
const subscription = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "subscribe_webhook",
  arguments: {
    event_name: "episode_created",
    show_id: "123456",
    url: "https://your-webhook-endpoint.com/hook"
  }
});

// Unsubscribe from webhook
const unsubscribe = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "unsubscribe_webhook",
  arguments: {
    webhook_id: "webhook123"
  }
});

获取经过身份验证的用户：

const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_authenticated_user",
  arguments: {}
});

授权音频文件上传：

// First, get a pre-signed upload URL
const auth = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "authorize_upload",
  arguments: {
    filename: "my-episode.mp3"
  }
});

// Then use the returned upload_url to upload your file via PUT request
// Finally, use the returned audio_url when creating your episode:
const episode = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "create_episode",
  arguments: {
    show_id: "123456",
    title: "My New Episode",
    audio_url: auth.data.attributes.audio_url
  }
});

覆盖

该服务器现在覆盖完整的晶体管API表面，剧集、分析、下载摘要、webhooks和私人播客订阅者管理层(GET/POST/PATCH/DELETE /v1/subscribers).