原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚 登录

OpenSubtitles

✓ 服务方 · opensubtitles.com

作者:opensubtitles版本 2.0.3i★ 2i电脑或云端官方网站 ↗
注册名称com.opensubtitles/mcp-server

安装方法

能做什么

从 OpenSubtitles.com 搜索、查看并下载电影和电视剧的字幕。

根据作者的说明自动翻译 · 团队尚未核对

  • 连接方式 电脑或云端
  • 账号或密钥 云端:不填密钥也能用 · 有 X-OpenSubtitles-Username, X-OpenSubtitles-Password, X-OpenSubtitles-Token, Api-Key 可以填上(通常能提高额度) · 本地:需要 OPENSUBTITLES_PASSWORD
  • 分类 游戏、体育、美食与学习
作者的原始说明
Search, inspect and download subtitles for movies and TV from OpenSubtitles.com.

为什么排在这里

列表按使用分(满分 100)排序,由以下部分组成

热度15/80GitHub 星标或每周下载量:较大的计 60,较小的计 20
新鲜度12/1230 天内有发布或代码更新得满分
仍在响应8/8上次检查时云端端点有响应
使用分35/100

质量: 基础检查通过 5/5 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)

安装

选择你使用的 AI 应用,然后复制设置。

用一句话让 AI 帮你安装

请帮我安装 OpenSubtitles。按照 https://mcp.popnx.com/i/opensubtitles-mcp-server.md 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文

通过 5/5 项检查 · 你的提问会经过开发者的服务器(mcp.opensubtitles.com) · ✓ 命令已检查 2026年11月22日

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude · 约 2 分钟

不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加

  1. 点击这个按钮,Claude 会打开已填好的添加 connector 窗口

    把 OpenSubtitles 添加到 Claude ↗

    名称和地址已为你填好,核对后点击 Add · 如果没有登录,Claude 会先让你登录

    在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add

    按钮无效?手动逐项填写

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4

    点击“Add” → “Custom” → “Web”,填写这 2 项

    把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue

    Name · 名称OpenSubtitles
    Remote MCP server URL · 地址https://mcp.opensubtitles.com/mcp
  2. 在聊天中开启

    +ConnectorsOpenSubtitles

  3. 试一试

    用 OpenSubtitles 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 OpenSubtitles,或回答中出现 OpenSubtitles 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

能否连接 ChatGPT 取决于方案

完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页

  1. 在网页版 ChatGPT 打开添加 MCP 的页面

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 填写名称和地址

    输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin

    Name · 名称OpenSubtitles
    Connection · 地址https://mcp.opensubtitles.com/mcp
  3. 在聊天中选择 OpenSubtitles

    开启新聊天,输入前先从插件列表中选择 OpenSubtitles

  4. 试一试

    用 OpenSubtitles 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 ChatGPT 说正在使用 OpenSubtitles,或回答中出现 OpenSubtitles 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Claude Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 打开终端

    Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell

  2. 粘贴这条命令并按 Enter

    claude mcp add --transport http --scope user opensubtitles https://mcp.opensubtitles.com/mcp
  3. 在 Claude Code 中输入 /mcp

    应能看到 OpenSubtitles 在列表中并显示已连接

  4. 试一试

    用 OpenSubtitles 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 OpenSubtitles,或回答中出现 OpenSubtitles 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  2. 在 Cursor 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 OpenSubtitles 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 OpenSubtitles,或回答中出现 OpenSubtitles 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  2. 在 VS Code 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 OpenSubtitles 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 OpenSubtitles,或回答中出现 OpenSubtitles 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

地址https://mcp.opensubtitles.com/mcp

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 OpenSubtitles 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

通过网页连接

Claude Code

claude mcp add --transport http --scope user opensubtitles https://mcp.opensubtitles.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "opensubtitles": {
      "url": "https://mcp.opensubtitles.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "opensubtitles": {
      "type": "http",
      "url": "https://mcp.opensubtitles.com/mcp"
    }
  }
}

安装在电脑上

Claude Code

claude mcp add --scope user opensubtitles --env OPENSUBTITLES_PASSWORD=your-value -- npx -y @opensubtitles/mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "opensubtitles": {
      "command": "npx",
      "args": [
        "-y",
        "@opensubtitles/mcp-server"
      ],
      "env": {
        "OPENSUBTITLES_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "opensubtitles": {
      "command": "npx",
      "args": [
        "-y",
        "@opensubtitles/mcp-server"
      ],
      "env": {
        "OPENSUBTITLES_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "opensubtitles": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@opensubtitles/mcp-server"
      ],
      "env": {
        "OPENSUBTITLES_PASSWORD": "your-value"
      }
    }
  }
}

需要你填写的值

  • OPENSUBTITLES_API_KEY 机密 env
    Optional own OpenSubtitles API key (https://www.opensubtitles.com/consumers); a built-in app key is used otherwise
  • OPENSUBTITLES_USERNAME env
    您的 OpenSubtitles 用户名,用于账户的下载配额和 VIP 状态
    查看英文原文Your OpenSubtitles username, for your account's download quota and VIP status
  • OPENSUBTITLES_PASSWORD 机密 必填 env
    您的 OpenSubtitles 密码
    查看英文原文Your OpenSubtitles password
  • X-OpenSubtitles-Username HTTP header
    您的 OpenSubtitles 用户名;与密码一起使用时,可按账户配额启用下载
    查看英文原文Your OpenSubtitles username; with the password, enables downloads on your account's quota
  • X-OpenSubtitles-Password 机密 HTTP header
    您的 OpenSubtitles 密码
    查看英文原文Your OpenSubtitles password
  • X-OpenSubtitles-Token 机密 HTTP header
    用户名/密码的替代方式:来自 OpenSubtitles API 的登录令牌
    查看英文原文Alternative to username/password: a login token from the OpenSubtitles API
  • Api-Key 机密 HTTP header
    可选的个人 OpenSubtitles API 密钥
    查看英文原文Optional own OpenSubtitles API key

说明为自动翻译,变量名保持原样;不确定时请查看原文。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

一览

每周下载量i
409/周
已验证域名
✓ opensubtitles.com
连接方式
电脑或云端
传输方式
stdio, streamable-http
最新版本i
2.0.3
发布到注册中心i
2026年11月22日
代码最后更新i
2026年11月22日
最近检查
2026年11月22日
作者
opensubtitles
软件包
npm: @opensubtitles/mcp-server
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

通过互联网连接,适用于

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

在你的电脑上运行,适用于

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

全部应用及其优缺点 →

它能做什么

工具名称和描述与服务器在 2026年11月22日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。

  • search_subtitles

    Find subtitles for a movie or TV episode and get file_ids to download. Search by title (query), video filename, IMDb/TMDB/feature id with optional season/episode, or moviehash; filter by language and flags. Results are ranked with exact title, episode and release-name matches fir

  • get_subtitle_details

    Full metadata for one subtitle from a search result: all files (multi-CD), uploader, comments, links, and related subtitles for the same title and language. Does not use download quota.

  • download_subtitle

    Download one subtitle file by file_id and return its text (or a temporary link), with optional format conversion, FPS conversion or time shift. Each call uses one download from the user's daily OpenSubtitles quota, so pick the file with search_subtitles first; the result reports

  • search_features

    Look up movies, TV shows and episodes on OpenSubtitles (title, year, IMDb/TMDB/feature ids, seasons and episode counts, subtitle counts per language). Use it to disambiguate a title before search_subtitles, or to find a show's seasons and episodes.

  • list_languages

    The subtitle language codes OpenSubtitles supports (e.g. en, pt-BR, zh-CN) with their names. Use the codes in search_subtitles.languages. Also available as the opensubtitles://languages resource.

  • guess_filename

    Parse a movie or episode filename with guessit-js (title, year, season, episode, release group, resolution, source, codec). Offline and free; use it to build a precise search_subtitles call, or pass the filename to search_subtitles directly.

  • get_user_info

    The logged-in OpenSubtitles user's level, VIP status, daily download allowance and downloads remaining, so you can plan downloads. Needs a configured login; does not use quota.

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月22日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过域名 opensubtitles.com 验证(注册中心会核实域名所有权)

  • ✓ 通过

    仍在维护

    代码最后更新于今天

  • ✓ 通过

    有许可证

    使用 MIT

  • ✓ 通过

    端点有响应

    在 356 毫秒内响应(HTTP 200)

  • – 不适用

    使用 OAuth 登录

    无需登录

  • ✓ 通过

    工具描述中没有隐藏指令

    已读取 7 个工具描述,未发现针对 AI 的隐藏指令

已公开的漏洞(OSV.dev)

尚未检查

我们检查什么 → · JSON

作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/opensubtitles-mcp-server.svg)](https://mcp.popnx.com/en/servers/opensubtitles-mcp-server)

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“游戏、体育、美食与学习”中的其他服务器比较i

  • 星标数多于此分类中其他 1720 个服务器的 91%
  • 发布到注册中心的时间比此分类中其他 1720 个服务器的 99% 更新
  • 基础检查结果等于或优于此分类中其他 1720 个服务器的 99%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

OpenSubtitles 安全吗?

它在 5 项适用的基础检查中通过了 5 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:OPENSUBTITLES_PASSWORD

它在我的电脑上运行还是在云端?

两种方式都可以:安装在你的电脑上,或者连接云端版本。

它还在维护吗?

GitHub 仓库最后更新于今天,最新版本(2.0.3)于今天进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。

有什么可以替代它?

同一分类中有:LearnHouse, Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

LearnHouse

Build, edit and run courses, learning paths and communities in your LearnHouse academy.

作者:learnhouse广泛使用★ 24903天前更新

在云端运行✓ 服务方 · learnhouse.app

WilmAI

Finland's Wilma school system for parents and students: schedule, homework, exams and messages.

作者:aikarjal正在增长↓ 1399/周★ 89 整个仓库的星标13天前更新

在你的电脑上运行✓ 服务方 · wilm.ai

Savecraft

Savecraft serves real save game data and expert game knowledge to AI assistants.

作者:joshsymonds起步阶段★ 137个月前更新

在云端运行仓库已归档✓ 服务方 · savecraft.gg
与相似项目对比
本项
OpenSubtitles
LearnHouseAnime GardenWilmAILumify Sports IntelligenceSavecraft
运行位置云端或安装在电脑上都可以在云端运行,无需安装在云端运行,无需安装需要安装在电脑上在云端运行,无需安装在云端运行,无需安装
需要密钥是否否否是否
可在 Claude 中按 + 添加否否否否否否
基础检查5/55/54/43/34/43/4
许可证MITAGPL-3.0AGPL-3.0MITMITApache-2.0
价格登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

OpenSubtitles MCP Server

The official Model Context Protocol server for OpenSubtitles.com. It lets AI agents find, inspect and download subtitles for movies and TV episodes in 100+ languages, and returns structured results an agent can reason over.

  • Remote: https://mcp.opensubtitles.com/mcp (Streamable HTTP)
  • Local: npx -y @opensubtitles/mcp-server (stdio)
  • Protocol: MCP 2026-07-28, plus 2025-era clients (2025-11-25, 2025-06-18, 2025-03-26) served statelessly
  • Registry: com.opensubtitles/mcp-server

Quick start

Claude Code
# Remote, search only (no account needed)

claude mcp add --transport http opensubtitles https://mcp.opensubtitles.com/mcp

Remote, with downloads on your account's quota (free account at opensubtitles.com)

claude mcp add --transport http opensubtitles https://mcp.opensubtitles.com/mcp \ --header "X-OpenSubtitles-Username: YOUR_USERNAME" \ --header "X-OpenSubtitles-Password: YOUR_PASSWORD"

Local (stdio): can also hash files on your disk

claude mcp add opensubtitles \ -e OPENSUBTITLES_USERNAME=YOUR_USERNAME -e OPENSUBTITLES_PASSWORD=YOUR_PASSWORD \ -- npx -y @opensubtitles/mcp-server

Add -s user to make it available in every project. An own API key is optional (--header "Api-Key: …" / -e OPENSUBTITLES_API_KEY=…, free at https://www.opensubtitles.com/consumers).

Claude Desktop (claude_desktop_config.json)
{

"mcpServers": { "opensubtitles": { "command": "npx", "args": ["-y", "@opensubtitles/mcp-server"], "env": { "OPENSUBTITLES_USERNAME": "YOUR_USERNAME", "OPENSUBTITLES_PASSWORD": "YOUR_PASSWORD" } } } }

Cursor (~/.cursor/mcp.json)
{

"mcpServers": { "opensubtitles": { "url": "https://mcp.opensubtitles.com/mcp", "headers": { "X-OpenSubtitles-Username": "YOUR_USERNAME", "X-OpenSubtitles-Password": "YOUR_PASSWORD" } } } }

VS Code (.vscode/mcp.json)
{

"servers": { "opensubtitles": { "type": "http", "url": "https://mcp.opensubtitles.com/mcp", "headers": { "X-OpenSubtitles-Username": "${input:os-user}", "X-OpenSubtitles-Password": "${input:os-pass}" } } }, "inputs": [ { "id": "os-user", "type": "promptString", "description": "OpenSubtitles username" }, { "id": "os-pass", "type": "promptString", "description": "OpenSubtitles password", "password": true } ] }

n8n

In the MCP Client Tool node, set *Endpoint* to https://mcp.opensubtitles.com/mcp and *Server Transport* to HTTP Streamable. For downloads, set *Authentication* to Custom Auth with the headers X-OpenSubtitles-Username and X-OpenSubtitles-Password (or Header Auth with X-OpenSubtitles-Token). /message still works but is deprecated (see Migration).

Credentials

Credentials are configuration, never tool arguments: they never pass through the model or the chat transcript, and the server never logs them.

stdio (environment)Remote (headers set in the client)
Login (recommended)OPENSUBTITLES_USERNAME + OPENSUBTITLES_PASSWORD (logs in once, caches and refreshes the token)X-OpenSubtitles-Username + X-OpenSubtitles-Password, or X-OpenSubtitles-Token:
API key (optional)OPENSUBTITLES_API_KEYApi-Key:
  • Search works anonymously (remote: the server's key, rate-limited per client).
  • Downloads use *your* account's quota: set your login (a free account is enough; VIP gets more). Your own API key is optional; without one the server's app key is used. Remote downloads with only an Api-Key and no login also work, but then count as anonymous.
  • Authorization: Bearer … from 1.x configs is still accepted as a fallback. Authorization is reserved for MCP OAuth, so use the X-OpenSubtitles-* headers.

Tools

ToolWhat it doesQuota
search_subtitlesFind subtitles by filename (parsed with guessit-js), query, imdb_id/tmdb_id/feature_id (+ season_number/episode_number) or moviehash. Filters: languages[], hearing_impaired, foreign_parts_only, include_ai_translated, include_machine_translated, trusted_only; order_by, page, per_page ≤ 100. Exact title/episode and release-name matches rank first.free
get_subtitle_detailsOne subtitle's full metadata, files, uploader comments and related subtitles.free
download_subtitleSubtitle text (or a temporary link) by file_id; optional sub_format, in_fps/out_fps, timeshift. Reports the remaining quota.1 download
search_featuresMovies, shows and episodes: ids, year, seasons/episodes, subtitle counts per language.free
list_languagesSupported language codes and names.free
guess_filenameParse a video filename (title, year, season, episode, release group…). Offline.free
calculate_file_hashOpenSubtitles moviehash + size of a local file. stdio only.free
get_user_infoYour level, VIP status and remaining downloads (needs a login).free

Every tool has a title, an inputSchema with real types and limits, an outputSchema with structuredContent plus a short text summary, and annotations. Errors the agent can fix come back as isError results with a suggestion (for example "No subtitles found; try: drop or widen languages (now de), drop year").

Resources: opensubtitles://guide/intelligent-search, opensubtitles://guide/limits, opensubtitles://languages. Prompts: find_subtitles_for_file, find_subtitles_for_title, sync_or_convert.

Migrating from 1.x

2.0.0 is a breaking release. The changes for existing users:

  1. Credentials moved out of tool arguments. username, password and user_api_key arguments are gone. Configure them once in the client (see Credentials).
  2. Endpoint: use https://mcp.opensubtitles.com/mcp. /message and /json still work and answer with a Deprecation header; they will be removed in a later 2.x release, with notice.
  3. Tool inputs: languages is an array (["en","pt-BR"]); hearing_impaired/foreign_parts_only are include|exclude|only; machine_translated/ai_translated/trusted_sources became booleans include_machine_translated, include_ai_translated, trusted_only; parent_imdb_id is now imdb_id with season_number/episode_number.
  4. Results are structured (structuredContent) with file_ids, paging (page, per_page, total_count, total_pages) and flags, not a Markdown top-5 list.
  5. `calculate_file_hash` exists only in local (stdio) mode. On the remote server, hash locally and pass moviehash.
  6. Removed: /debug, /proxy, the mcp-opensubtitles-remote/-http binaries.

Run your own

npx -y @opensubtitles/mcp-server --http          # 127.0.0.1:1620, endpoint /mcp

docker build -t opensubtitles-mcp . && docker run -p 1620:1620 -e OPENSUBTITLES_API_KEY=… opensubtitles-mcp

VariableDefaultMeaning
PORT / HOST1620 / 127.0.0.1 (Docker image: 0.0.0.0)Listen address
OPENSUBTITLES_API_KEYbuilt-in app keystdio: your key. http: server key for anonymous search
OPENSUBTITLES_API_BASEhttps://api.opensubtitles.com/api/v1REST API base
ALLOWED_ORIGINSclaude.ai, claude.com, mcp.opensubtitles.comBrowser Origins allowed (others get 403). * allows all
ALLOWED_HOSTS(any)Restrict the Host header
TRUST_PROXYoffRead the client IP from CF-Connecting-IP / X-Forwarded-For
RATE_LIMIT_PER_MINUTE120Per client (API key, login or IP), per replica
MAX_BODY_BYTES1048576Request body limit
LOG_LEVEL, LOG_SALTinfo, …JSON logs on stderr; client ids are salted hashes

Endpoints: POST /mcp, GET /health → {"status":"ok","version":"2.0.0"}, GET /llms.txt, GET /.

Logs are JSON lines (OpenObserve-ready): tool name, duration, status, HTTP status, anonymised client id and W3C trace id. Never arguments, headers, tokens or passwords. Each download also writes an audit.download event with a per-client counter.

Development

npm ci

npm test # build + 120+ tests (unit, both protocol eras, raw HTTP, stdio e2e, log/secret checks) npm run smoke:inspector # MCP Inspector CLI over stdio and HTTP npx @modelcontextprotocol/inspector node dist/index.js

Related

  • guessit-js: the filename parser behind filename and guess_filename, also an MCP server (npx -y guessit-js --mcp, https://guessit.opensubtitles.com/mcp).
  • OpenSubtitles REST API

License

MIT