MandarinClips Authentic Chinese Cinema Corpus

MandarinClips MCP 服务 🎬

Model Context Protocol (MCP) 官方服务，适用于 MandarinClips —— 这是一套为中文教育者（TCSL）和高级学习者设计的语言学电影语料库。

将 Claude Desktop、Cursor 和 AI Agent 无缝连接到一个包含 180,000+ 条真实中文影视对白片段的数据库，并提供原生音频引用、HSK 3.0 语法公式和真实语用潜台词。

---

🌟 为什么选择 MandarinClips MCP？

传统教材教授的是刻板的中文对话。真实的母语表达充满了微妙的文化潜台词、对话中的委婉表达和口语习语。

这个 MCP 服务让大模型能够设计真实、以电影为依托的中文教案、练习和词汇指南：

• 真实影视语境：提供真实的视频对话轮次序列（前句、目标句和后续句），而非机器生成的刻板句子。
• 教学索引：可按 HSK 3.0 等级（1 至 7-9）、句法语法模式或社交语用场景（例如，礼貌拒绝、职场争执）搜索。
• 直接 Markdown 引用：每个检索到的示例都会自动附上真实场景链接，直接指向 MandarinClips。

---

🚀 快速开始：使用 Claude Desktop 进行设置

将此配置添加到 Claude Desktop 配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

1. 匿名 / 免费套餐（默认）

通过 npx 直接运行，无需安装：

{
  "mcpServers": {
    "mandarinclips": {
      "command": "npx",
      "args": ["-y", "mandarinclips-mcp"]
    }
  }
}

2. 使用 API 密钥（更高配额）

如需每天免费查询 8 次或无限使用 Pro 权限，请从 MandarinClips Account Dashboard 获取 API 密钥：

{
  "mcpServers": {
    "mandarinclips": {
      "command": "npx",
      "args": ["-y", "mandarinclips-mcp"],
      "env": {
        "MANDARINCLIPS_API_KEY": "mc_live_your_api_key_here"
      }
    }
  }
}

重启 Claude Desktop，即可在工具栏中看到可用的 MandarinClips 工具！

---

🧰 可用工具

工具名称	说明	参数
search_cinema_clips	按汉字、拼音或英文主题搜索 180,000+ 条真实影视对白。	query (str), hsk_level (opt int 1-7), limit (opt int 1-20)
get_grammar_guide	获取语法模式的结构化句式公式和真实对话示例。	slug (e.g., 'hai-shi-ba', 'lian-dou')
get_expression_guide	查询影视语境中的口语习语、俚语和文化细微差异。	slug (e.g., 'hai-shi-suan-le-ba', 'bu-de-bu')
get_hsk_vocabulary	获取官方 HSK 3.0 词汇表，包括释义和关联视频数量。	level (int 1-7), page (opt int), limit (opt int)
get_word_detail	获取汉字或词语的详细词典信息，并显示关联的影视片段。	slug (e.g., 'ai-6', 'zuo-tian')

---

🎯 在 Claude 中尝试的示例提示词

• "为 HSK 3 学生设计一份 45 分钟的课程计划，讲解“还是…吧”结构。使用 MandarinClips 查找 3 个真实的电影对白示例。"
• "给我 5 个真实的视频示例，展示中文母语者在日常生活中如何礼貌地拒绝邀请。"
• "提取与食物相关的 HSK 2 级词汇，提供拼音、释义，并附上对应的视频引用链接。"

---

🔑 每日分级配额

MandarinClips 实行公平使用的每日配额：

• 匿名用户（无 API 密钥）：每天 3 次查询（按 IP 地址计算）。
• 免费账户：每天 8 次查询。获取免费 API 密钥。
• Pro 订阅用户：通过 Patreon 可无限查询并高速导出。
• 教育工作者与教授：通过 学术访问计划 申请免费 3 个月的 Pro 许可证。

---

🏛️ 生态系统与链接

• 🌐 Web 平台：https://www.mandarinclips.com
• 🎓 HSK 3.0 课程：探索 HSK 词汇图谱
• 📐 语法库：浏览句型
• 📌 表达方式与习语：口语短语目录
• 🎭 语用场景：真实社交场景
• 📰 官方博客：中文教学见解

---

📄 许可证

MIT License © 2026 MandarinClips 团队。