Frinkiac MCP

Frinkiac MCP服务器

用于搜索电视节目截图和生成模因的模型上下文协议（MCP）服务器。搜索对话，检索场景信息，并从您最喜欢的节目中创建自定义模因图像。

支持的节目

安装

npm install @ryantenney/frinkiac-mcp

或者直接使用npx运行：

npx @ryantenney/frinkiac-mcp

配置

克劳德桌面版

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "frinkiac": {
      "command": "npx",
      "args": ["@ryantenney/frinkiac-mcp"]
    }
  }
}

其他MCP客户端

服务器使用标准MCP协议通过stdio进行通信。配置您的客户端以运行：

npx @ryantenney/frinkiac-mcp

工具

search

按对话文本搜索场景。

重要提示： 这会从剧集字幕中搜索实际的口语对话。您无法搜索：

• 场景描述（例如，“荷马吃甜甜圈”）
• 仅角色名称（例如“Marge Simpson”）
• 视觉元素（例如，“沙发插科打诨”）
• 情节摘要（例如，“荷马去太空的那一集”）

参数：

• show （必填）：显示以进行搜索(simpsons, futurama, rickandmorty, 30rock)
• query （必填）：要搜索的对话文本
• limit （可选）：返回的最大结果数
• include_images （可选）：包含小缩略图（160x120）以显示结果（最多5个）

例子：

{
  "show": "simpsons",
  "query": "D'oh!",
  "limit": 10,
  "include_images": true
}

get_caption

获取特定场景的详细信息，包括剧集元数据、字幕和附近的帧。

参数：

• show （必填）：显示使用
• episode （必填）：S##E##格式的剧集密钥（例如“S07E21”）
• timestamp （必填）：帧时间戳（毫秒）
• include_nearby_images （可选）：包括附近帧的小缩略图（160x120）

例子：

{
  "show": "simpsons",
  "episode": "S07E21",
  "timestamp": 871871,
  "include_nearby_images": true
}

get_nearby_frames

获取给定时间戳的附近帧列表。可用于浏览相邻的屏幕截图以找到完美的框架。

参数：

• show （必填）：显示使用
• episode （必填）：S##E##格式的剧集密钥（例如“S07E21”）
• timestamp （必填）：帧时间戳（毫秒）
• include_images （可选）：包括每帧的小缩略图（160x120）

例子：

{
  "show": "simpsons",
  "episode": "S07E21",
  "timestamp": 871871,
  "include_images": true
}

get_episode

获取时间戳范围内的剧集元数据和字幕。返回该范围的字幕计数。

参数：

• show （必填）：显示使用
• episode （必填）：S##E##格式的剧集密钥
• start_timestamp （必填）：范围开始时间（毫秒）
• end_timestamp （必填）：范围结束（毫秒）

例子：

{
  "show": "futurama",
  "episode": "S02E15",
  "start_timestamp": 0,
  "end_timestamp": 60000
}

get_screenshot

从特定场景中获取屏幕截图。

参数：

• show （必填）：显示使用
• episode （必填）：S##E##格式的剧集密钥
• timestamp （必填）：帧时间戳（毫秒）
• return_url_only （可选）：仅返回URL而不是实际图像

例子：

{
  "show": "simpsons",
  "episode": "S08E02",
  "timestamp": 544627
}

generate_meme

在屏幕截图上生成带有自定义文本覆盖的模因图像。文本会根据显示字体自动包装。

参数：

• show （必填）：显示使用
• episode （必填）：S##E##格式的剧集密钥
• timestamp （必填）：帧时间戳（毫秒）
• text （必填）：要叠加在图像上的文本（自动换行）
• return_url_only （可选）：仅返回URL而不是实际图像

例子：

{
  "show": "simpsons",
  "episode": "S05E02",
  "timestamp": 789456,
  "text": "When the code finally compiles after mass amounts of debugging"
}

提示

服务器为常见任务提供有指导的工作流提示：

find_quote

根据你的记忆，帮助你找到一个具体的引文或场景。

论据：

• description （必填）：你对引文或场景的记忆
• show （可选）：搜索哪个节目

create_meme

引导您完成寻找场景和创建模因的过程。

论据：

• idea （必填）：你的模因想法或你想在模因上显示的文本
• show （可选）：使用哪个节目

explain_scene

为特定场景提供背景和解释。

论据：

• show （必填）：哪个节目
• episode （必填）：S##E##格式的剧集
• timestamp （必填）：时间戳（毫秒）

reverse_meme

通过分析情绪，为给定的模因文本找到合适的场景。

论据：

• text （必填）：您要使用的模因文本
• show （可选）：搜索哪个节目

资源

frinkiac://shows

列出所有可用的节目及其ID、名称和相关服务。

剧集格式

剧集使用该格式 S{SS}E{EE}:

• SS =两位数的季节编号（01-35）
• EE =两位数的剧集编号（01-99）

示例：

• S07E21 =第七季第21集
• S12E21 =第12季第21集

时间戳

帧时间戳是表示从剧集开始算起的毫秒数的整数。一个典型的22分钟剧集的时间戳范围从0到大约1400000。

使用提示

1. 从搜索开始 查找与您记忆中的对话相匹配的场景
2. 使用 get_caption 获取场景的更多上下文并发现附近的帧
3. 使用 get_nearby_frames 和 include_images 直观浏览相邻帧
4. 预览 get_screenshot 在生成模因以验证你有正确的框架之前
5. 生成表情包 使用自定义文本-长文本会自动包装
6. 使用提示 用于查找引文或创建表情包等指导性工作流程

发展

# Clone the repository
git clone https://github.com/ryantenney/frinkiac-mcp.git
cd frinkiac-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

许可证

MIT许可证-请参阅 许可证 了解详情。

学分

此MCP服务器与以下社区创建的屏幕截图搜索服务进行交互：

• 弗里克语 -辛普森一家
• 莫博特隆 -Futurama
• 所有科学硕士 -里克和莫蒂
• 上帝啊柠檬 -30岩石