Skip to content
Back to search

nhipo-mcp

MCP server built into Nhipo, the local AI video editor: let Claude, Cursor & co. edit videos, make SFX and animated stories on your PC

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ph92g--nhipo-mcp/badge.svg)](/listings/ph92g--nhipo-mcp)

HTML

<a href="/listings/ph92g--nhipo-mcp"><img src="/api/listings/ph92g--nhipo-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 121 lines
  1. # Nhipo MCP server – let your AI assistant edit videos on your PC
  2. [Nhipo](https://discord.gg/N2J3XP6puh) is an AI video editor that runs **entirely on your computer**. Your footage is never
  3. uploaded. Nhipo ships with a built-in [Model Context Protocol](https://modelcontextprotocol.io) server, so Claude Code,
  4. Claude Desktop, Cursor and any other MCP client can drive it: "turn these clips into a 30-second vertical video with
  5. captions", "dub this drama into English", "check my export for cut-off faces", "make me a whoosh sound".
  6. - **Local:** the server talks over stdio only. It opens no network port and never posts anything online.
  7. - **Same engine as the app:** cuts, captions, music, framing, sound effects, animated stories and the video checker are
  8. the ones the Nhipo app uses, with the same plan limits.
  9. - **One install:** the server is part of the Nhipo app (`Nhipo.exe --mcp`). There is nothing else to download.
  10. ## Requirements
  11. - Windows 10 or 11, 64-bit
  12. - Nhipo **2.7.7 or newer**. Download it for free from the `#download` channel of the
  13. [Nhipo Discord](https://discord.gg/N2J3XP6puh).
  14. ## Connect your AI assistant
  15. **Easiest:** in Nhipo, open the menu ☰ → **Connect an AI assistant (MCP)**, then click **Connect** next to Claude Desktop
  16. or Cursor. Nhipo adds itself to that app's MCP config (it keeps your other servers and saves a backup) and shows the
  17. command for Claude Code. Restart the assistant afterwards.
  18. **With npx** (Node.js 18+): the `nhipo-mcp` launcher finds your Nhipo install and starts its server. If Nhipo is not
  19. installed yet, the assistant gets a `nhipo_setup` tool that explains how to get it.
  20. ```json
  21. { "mcpServers": { "nhipo": { "command": "npx", "args": ["-y", "nhipo-mcp"] } } }
  22. ```
  23. ```powershell
  24. claude mcp add nhipo -s user -- npx -y nhipo-mcp
  25. ```
  26. Set `NHIPO_EXE` to the full path of `Nhipo.exe` if you installed Nhipo in a custom folder.
  27. **By hand:** the default install folder is `%LOCALAPPDATA%\Programs\Nhipo`. Change the path below if you installed Nhipo somewhere
  28. else.
  29. **Claude Code**
  30. ```powershell
  31. claude mcp add nhipo -s user -- "$env:LOCALAPPDATA\Programs\Nhipo\Nhipo.exe" --mcp
  32. ```
  33. **Claude Desktop** (`%APPDATA%\Claude\claude_desktop_config.json`), **Cursor** (`.cursor\mcp.json`) and other clients:
  34. ```json
  35. {
  36. "mcpServers": {
  37. "nhipo": {
  38. "command": "C:\\Users\\YOU\\AppData\\Local\\Programs\\Nhipo\\Nhipo.exe",
  39. "args": ["--mcp"]
  40. }
  41. }
  42. }
  43. ```
  44. The server runs without a window. It works whether or not the Nhipo app is open.
  45. ## Tools
  46. | Tool | What it does |
  47. |---|---|
  48. | `create_from_videos` | AI-edits a short video from 1–20 source clips (cuts, captions, music, framing; 9:16, 1:1 or 16:9) and exports an MP4 |
  49. | `export_status` | Progress and result of a video job: percent, step, time left, then the MP4 path, size and duration |
  50. | `job_status` / `job_cancel` | Status of any long job, or cancel it |
  51. | `dub_video` | Translates a video's speech into one of 12 languages and dubs it with new voices: keeps the background music, reads burned-in subtitles and covers them with translated ones |
  52. | `sfx_generate` | Text description → new sound effect (WAV) |
  53. | `story_build` | Animated storytelling video (AI-written story, on-device painter, voice-over) |
  54. | `review_video` | Watches a video and lists flaws (cut-off faces, captions over faces, frozen or flickering frames, blur…) with timestamps and fixes |
  55. | `list_videos` | Lists the videos in a folder, newest first, to pick sources |
  56. | `nhipo_status` | Version, your plan and its limits, folders the server may use, running jobs |
  57. **Prompts** (shown as `/` commands in Claude Desktop and Claude Code): `short_video` (folder → captioned short video →
  58. flaw check), `dub_video`, `animated_story`, `check_video`.
  59. Long jobs run one at a time in the background. A tool returns a `jobId` straight away, and your assistant follows up with
  60. `export_status` or `job_status`.
  61. ## Plans
  62. The MCP server uses your Nhipo plan, exactly like the app. The Free plan can export AI edits of up to 60 seconds and has
  63. small daily quotas for AI effects and stories. Ask your assistant to run `nhipo_status` to see your limits. Keys and
  64. upgrades are in the [Nhipo Discord](https://discord.gg/N2J3XP6puh).
  65. ## Files and privacy
  66. - **Reads** video files from your Videos, Desktop, Downloads, Documents and Pictures folders, and from Nhipo's export
  67. folder.
  68. - **Writes** only to Nhipo's export folder (Settings → video folder, `Videos\Nhipo` by default).
  69. - Paths must be absolute. Network paths and NTFS alternate data streams are refused.
  70. - The server never reads your account tokens or API keys and has no tool that publishes anything.
  71. ## Try it
  72. > Edit `C:\Users\me\Videos\trip\*.mp4` into a 30-second 9:16 video with captions, then check it for problems.
  73. > Dub `C:\Users\me\Downloads\drama-ep1.mp4` into English and cover the Chinese subtitles.
  74. > Make a short animated story about a cat who learns to surf, 9:16.
  75. > Generate a soft "pop" UI sound and save it to my Nhipo video folder.
  76. ## Help
  77. Questions, bug reports and feature ideas: [Nhipo Discord](https://discord.gg/N2J3XP6puh).
  78. ---
  79. ### Tiếng Việt
  80. Nhipo là app dựng video bằng AI chạy hoàn toàn trên máy bạn. Từ bản 2.7.7, Nhipo có sẵn máy chủ MCP: trợ lý AI (Claude
  81. Code, Claude Desktop, Cursor…) dựng video, tạo âm thanh, làm hoạt hình kể chuyện và soi lỗi video bằng Nhipo. Kết nối
  82. Claude Code bằng lệnh ở trên (`Nhipo.exe --mcp`). Tải Nhipo miễn phí và hỏi đáp tại [Discord Nhipo](https://discord.gg/N2J3XP6puh).
  83. ---
  84. This repository holds the documentation and the small `nhipo-mcp` launcher (`bin/nhipo-mcp.js`, no dependencies). The
  85. MCP server itself ships inside the Nhipo app. Nhipo is free to download. © Nhipo.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.