LearnHouse
Build, edit and run courses, learning paths and communities in your LearnHouse academy.
ค้นหา ตรวจสอบ และดาวน์โหลดคำบรรยายใต้ภาพสำหรับภาพยนตร์และรายการทีวีจาก OpenSubtitles.com
แปลอัตโนมัติจากคำอธิบายของผู้ทำ · ทีมยังไม่ได้ตรวจ
Search, inspect and download subtitles for movies and TV from OpenSubtitles.com.หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 15/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 8/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 35/100 |
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 5/5 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง OpenSubtitles ให้หน่อย ทำตาม https://mcp.popnx.com/i/opensubtitles-mcp-server.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (mcp.opensubtitles.com) · ✓ ตรวจคำสั่งแล้ว 22 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม
เพิ่ม OpenSubtitles ใน Claude ↗
ชื่อกับที่อยู่ถูกกรอกให้แล้ว ตรวจแล้วกด Add · ถ้ายังไม่ได้ล็อกอิน Claude จะให้ล็อกอินก่อน
กด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add
CustomizeConnectors
กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้
คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue
OpenSubtitleshttps://mcp.opensubtitles.com/mcp+ConnectorsOpenSubtitles
ใช้ OpenSubtitles บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ OpenSubtitles หรือมีชื่อเครื่องมือของ OpenSubtitles ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ ChatGPT ได้ ขึ้นกับแผน
MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น
Plugins+Add custom MCP server
ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin
OpenSubtitleshttps://mcp.opensubtitles.com/mcpเปิดแชตใหม่แล้วเลือก OpenSubtitles จากรายการปลั๊กอินก่อนพิมพ์
ใช้ OpenSubtitles บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า ChatGPT บอกว่ากำลังใช้ OpenSubtitles หรือมีชื่อเครื่องมือของ OpenSubtitles ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Claude Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
claude mcp add --transport http --scope user opensubtitles https://mcp.opensubtitles.com/mcpต้องเห็น OpenSubtitles ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ใช้ OpenSubtitles บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ OpenSubtitles หรือมีชื่อเครื่องมือของ OpenSubtitles ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
ใช้ OpenSubtitles บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ OpenSubtitles หรือมีชื่อเครื่องมือของ OpenSubtitles ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
ใช้ OpenSubtitles บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ OpenSubtitles หรือมีชื่อเครื่องมือของ OpenSubtitles ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ
https://mcp.opensubtitles.com/mcpค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
Claude Code
claude mcp add --transport http --scope user opensubtitles https://mcp.opensubtitles.com/mcpCursor (~/.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='ใส่ค่าของคุณ' -- npx -y @opensubtitles/mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"opensubtitles": {
"command": "npx",
"args": [
"-y",
"@opensubtitles/mcp-server"
],
"env": {
"OPENSUBTITLES_PASSWORD": "ใส่ค่าของคุณ"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"opensubtitles": {
"command": "npx",
"args": [
"-y",
"@opensubtitles/mcp-server"
],
"env": {
"OPENSUBTITLES_PASSWORD": "ใส่ค่าของคุณ"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"opensubtitles": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@opensubtitles/mcp-server"
],
"env": {
"OPENSUBTITLES_PASSWORD": "ใส่ค่าของคุณ"
}
}
}
}OPENSUBTITLES_API_KEY ความลับ envOPENSUBTITLES_USERNAME envOPENSUBTITLES_PASSWORD ความลับ จำเป็น envX-OpenSubtitles-Username HTTP headerX-OpenSubtitles-Password ความลับ HTTP headerX-OpenSubtitles-Token ความลับ HTTP headerApi-Key ความลับ HTTP headerคำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
npm: @opensubtitles/mcp-serverดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ต่อผ่านคลาวด์ได้ใน
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
ชื่อและคำอธิบายเครื่องมือตามที่ server ตอบมาเมื่อ 22 พ.ย. 2569 ผู้ทำเป็นคนเขียน ไม่ใช่เรา แสดงเป็นข้อความล้วน
search_subtitlesFind 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_detailsFull 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_subtitleDownload 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_featuresLook 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_languagesThe 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_filenameParse 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_infoThe 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.
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 22 พ.ย. 2569
ชื่อใน registry ยืนยันโดเมน opensubtitles.com แล้ว (registry ตรวจความเป็นเจ้าของโดเมน)
มีการแก้โค้ดล่าสุด วันนี้
ใช้ MIT
ตอบกลับใน 356 ms (HTTP 200)
ไม่ต้องล็อกอิน
อ่านคำอธิบายเครื่องมือ 7 ตัวแล้ว ไม่พบคำสั่งแอบแฝงถึง AI
ยังไม่ได้ตรวจ
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/opensubtitles-mcp-server)ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
ยังไม่มีรีวิว
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใส่ค่าเหล่านี้: OPENSUBTITLES_PASSWORD
ได้ทั้งสองแบบ จะลงในเครื่องหรือต่อผ่านคลาวด์ก็ได้
repo บน GitHub มีการแก้โค้ดล่าสุด วันนี้ และส่งรุ่นล่าสุด (2.0.3) เข้า registry วันนี้
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)
ในหมวดเดียวกันมี LearnHouse, Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Build, edit and run courses, learning paths and communities in your LearnHouse academy.
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft serves real save game data and expert game knowledge to AI assistants.
| ตัวนี้ OpenSubtitles | LearnHouse | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | มีทั้งบนคลาวด์และแบบลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง |
| ต้องใส่คีย์ | ใช่ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ |
| ผลตรวจเบื้องต้น | 5/5 | 5/5 | 4/4 | 3/3 | 4/4 | 3/4 |
| สัญญาอนุญาต | MIT | AGPL-3.0 | AGPL-3.0 | MIT | MIT | Apache-2.0 |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
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.
https://mcp.opensubtitles.com/mcp (Streamable HTTP)npx -y @opensubtitles/mcp-server (stdio)com.opensubtitles/mcp-server# Remote, search only (no account needed)
claude mcp add --transport http opensubtitles https://mcp.opensubtitles.com/mcp
claude mcp add --transport http opensubtitles https://mcp.opensubtitles.com/mcp \ --header "X-OpenSubtitles-Username: YOUR_USERNAME" \ --header "X-OpenSubtitles-Password: YOUR_PASSWORD"
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_config.json){
"mcpServers": { "opensubtitles": { "command": "npx", "args": ["-y", "@opensubtitles/mcp-server"], "env": { "OPENSUBTITLES_USERNAME": "YOUR_USERNAME", "OPENSUBTITLES_PASSWORD": "YOUR_PASSWORD" } } } }
~/.cursor/mcp.json){
"mcpServers": { "opensubtitles": { "url": "https://mcp.opensubtitles.com/mcp", "headers": { "X-OpenSubtitles-Username": "YOUR_USERNAME", "X-OpenSubtitles-Password": "YOUR_PASSWORD" } } } }
.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 } ] }
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 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_KEY | Api-Key: |
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.| Tool | What it does | Quota |
|---|---|---|
search_subtitles | Find 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_details | One subtitle's full metadata, files, uploader comments and related subtitles. | free |
download_subtitle | Subtitle text (or a temporary link) by file_id; optional sub_format, in_fps/out_fps, timeshift. Reports the remaining quota. | 1 download |
search_features | Movies, shows and episodes: ids, year, seasons/episodes, subtitle counts per language. | free |
list_languages | Supported language codes and names. | free |
guess_filename | Parse a video filename (title, year, season, episode, release group…). Offline. | free |
calculate_file_hash | OpenSubtitles moviehash + size of a local file. stdio only. | free |
get_user_info | Your 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.
2.0.0 is a breaking release. The changes for existing users:
username, password and user_api_key arguments are gone. Configure them once in the client (see Credentials).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.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.structuredContent) with file_ids, paging (page, per_page, total_count, total_pages) and flags, not a Markdown top-5 list.moviehash./debug, /proxy, the mcp-opensubtitles-remote/-http binaries.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
| Variable | Default | Meaning |
|---|---|---|
PORT / HOST | 1620 / 127.0.0.1 (Docker image: 0.0.0.0) | Listen address |
OPENSUBTITLES_API_KEY | built-in app key | stdio: your key. http: server key for anonymous search |
OPENSUBTITLES_API_BASE | https://api.opensubtitles.com/api/v1 | REST API base |
ALLOWED_ORIGINS | claude.ai, claude.com, mcp.opensubtitles.com | Browser Origins allowed (others get 403). * allows all |
ALLOWED_HOSTS | (any) | Restrict the Host header |
TRUST_PROXY | off | Read the client IP from CF-Connecting-IP / X-Forwarded-For |
RATE_LIMIT_PER_MINUTE | 120 | Per client (API key, login or IP), per replica |
MAX_BODY_BYTES | 1048576 | Request body limit |
LOG_LEVEL, LOG_SALT | info, … | 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.
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
filename and guess_filename, also an MCP server (npx -y guessit-js --mcp, https://guessit.opensubtitles.com/mcp).MIT