Mindvalley产品MCP服务器
](https://badge.fury.io/js/mindvalley-products-mcp)  ](https://github.com/mazemax/mindvalley-products-mcp/actions)
一个模型上下文协议（MCP）服务器，为AI助手提供结构化访问Mindvalley教育产品的途径，包括课程、大师班、项目以及认证。
✨ 特点/功能
- 🚀 这个表情符号在中文里通常被理解为“火箭”或“快速前进”的意思，也可以用来表示兴奋、期待或快速发展的状态。所以，可以翻译为“🚀（火箭/快速前进）”或者根据上下文具体表达为相应的意思。 4 MCP 工具 - 获取产品、大师班课程、项目和认证
- 🔒（锁形符号，常用于表示安全、保密或锁定状态） 只读且安全 - 对静态数据进行非破坏性操作
- ⚡ 闪电符号（在中文语境中，此符号常被用来表示速度、活力或紧急情况，但无直接对应的中文翻译，故保留原符号） 快速性能 - 无外部API调用，即时响应
- 🎯（瞄准目标） 智能过滤 - 针对性查询的可选参数
- 🔧（扳手） 轻松集成 - 与Claude桌面版、Cursor集成开发环境（IDE）以及自定义客户端兼容
- 📚 书籍 完整的文件记录 - 全面的示例和指南
🚦 快速入门
安装
# Install globally for easy access
npm install -g mindvalley-products-mcp
# Or install locally in your project
npm install mindvalley-products-mcp与Claude桌面版的使用
- 添加到Claude桌面配置中 (
~/Library/Application Support/Claude/claude_desktop_config.json（在 macOS 上）：
{
"mcpServers": {
"mindvalley-products": {
"command": "npx",
"args": ["mindvalley-products-mcp"]
}
}
}- 重启Claude桌面版 并开始提出诸如以下问题：
- “Mindvalley提供哪些产品？” - “给我看看Jim Kwik的名师课程” - “思维类的节目有哪些？”
🛠️ 可用工具
1. 产品 - Mindvalley核心产品
获取关于Mindvalley订阅产品及价格的信息。
// Get all products
products();
// Get specific product
products({ name: "Mindvalley Membership" });响应内容包括产品名称、描述、定价（月度/年度）、结账页面URL
2. 大师班 - 免费大师班
获取当前Mindvalley大师班的报名链接。
// Get all masterclasses
masterclasses();
// Filter by title
masterclasses({ title: "Superbrain" });响应包括大师班标题、主持人、描述、报名网址
3. 程序（或项目、方案，具体根据上下文确定） - 教育项目
浏览Mindvalley按类别组织的学习课程。
// Get all programs (by category)
programs();
// Get programs in specific category
programs({ category: "Mind" });可用类别心智、身体、灵魂、职业、创业、人际关系、育儿
4. 认证 - 教练认证
关于Mindvalley专业认证的信息。
// Get all certifications
certifications();
// Filter by name
certifications({ name: "Life Coach" });响应内容包括认证名称、提供机构、有效期、要求、注册网址
📖 集成指南
Claude Desktop（可译为“Claude桌面版”或保持原样，具体根据上下文判断是否需要意译）
详细的设置指南： examples/claude-desktop/README.md
Cursor 集成开发环境（IDE）
集成说明： examples/cursor/README.md
自定义MCP客户端
程序化使用示例： examples/mcp-client/README.md
💡 示例用例
个人学习规划
用户“我想提高记忆力和专注力。Mindvalley能提供什么？” 人工智能回复根据您的兴趣，我找到了几个相关的选项： 大师班（免费）与吉姆·奎克一起的超级大脑大师课——“解锁你的记忆与脑力” 程序《超脑力》（作者：吉姆·奎克）——全面的记忆提升计划 同样相关《专注力：如何成为不受干扰的高效人士》（作者：尼尔·埃亚尔），职业类书籍
产品对比
用户“比较Mindvalley会员与Pro会员” 人工智能回复以下是对比： 心灵山谷会员 （499美元/年或99美元/月） - 订阅即享100多个任务和冥想课程的全访问权限 Mindvalley会员专业版 （仅需698美元/年） - 会员专享的一切内容，外加实时辅导课程 - 额外支付每年199美元以获得实时辅导服务
认证研究
用户“我想成为一名认证教练。Mindvalley有哪些选择？” 人工智能回应Mindvalley通过Evercoach提供多种教练认证： 认证人生教练 （4个月）- 200美元可退还押金 认证商业教练 （4个月）- 针对企业/高管辅导 认证催眠治疗师 （16周）- 由保罗·麦肯纳主持
🔧 开发
本地开发
# Clone the repository
git clone https://github.com/mazemax/mindvalley-products-mcp.git
cd mindvalley-products-mcp
# Install dependencies
pnpm install
# Build the server
pnpm run build
# Run tests
pnpm test
# Start development mode (with hot-reload)
pnpm run dev项目结构
mindvalley-products-mcp/
├── src/
│ ├── tools/ # MCP tool implementations
│ │ ├── products.ts
│ │ ├── masterclasses.ts
│ │ ├── programs.ts
│ │ └── certifications.ts
│ └── resources/ # Static data source
│ └── mindvalley_data.json
├── examples/ # Integration examples
│ ├── claude-desktop/
│ ├── cursor/
│ └── mcp-client/
├── dist/ # Built server files
└── docs/ # Additional documentation添加新工具
- 在（某个位置）创建一个新文件
src/tools/ - 出口
schema，metadata和默认函数 - XMCP自动发现并注册该工具
import { z } from "zod";
import data from "../resources/mindvalley_data.json";
export const schema = {
filter: z.string().optional().describe("Filter parameter"),
};
export const metadata = {
name: "new-tool",
description: "Description of what the tool does",
annotations: {
title: "New Tool",
readOnlyHint: true,
destructiveHint: false,
idempotentHint: true,
},
};
export default async function newTool({ filter }: { filter?: string }) {
// Implementation
return { content: [{ type: "text", text: JSON.stringify(result) }] };
}🔍 故障排除
常见问题
❌“命令未找到：mindvalley-products-mcp”
# Verify installation
npm list -g mindvalley-products-mcp
# Reinstall if needed
npm install -g mindvalley-products-mcp❌ “服务器启动失败”
# Check Node.js version (requires >=20.0.0)
node --version
# Test the server directly
npx mindvalley-products-mcp
# Check for error messages in AI assistant logs❌“AI助手中不可用的工具”
- 配置更改后重启您的AI助手
- 验证MCP配置文件中的JSON语法
- 检查服务器路径是否正确
测试服务器
在集成之前单独测试服务器：
# Test if server starts correctly
npx mindvalley-products-mcp
# Run the test suite
cd examples/mcp-client
node example.js配置验证
验证您的MCP配置：
# Check Claude Desktop config
cat "~/Library/Application Support/Claude/claude_desktop_config.json" | jq
# Test configuration syntax
node -e "console.log(JSON.parse(require('fs').readFileSync('config.json')))"🤝 贡献
我们欢迎投稿！请参阅我们的 贡献指南 详情请参阅。
快速贡献步骤
- 为仓库创建分支（或：克隆仓库）
- 创建一个特性分支：
git checkout -b feature/amazing-feature - 进行你的更改并添加测试
- 运行测试：
pnpm test - 提交：
git commit -m 'Add amazing feature' - 推送：
git push origin feature/amazing-feature - 提交一个拉取请求
贡献类型
- 这个表情符号“🐛”代表的是“虫子”，在中文里可以直接翻译为“虫子”或者根据语境稍作变化，比如“小虫子”、“虫”等。它通常用来表示对某物或某情况的不满、厌恶，或者用来开玩笑地指某人或某事像虫子一样（可能是指其行为或特质让人不悦）。在正式场合使用时，需注意其可能带来的负面含义。 错误修复 - 修复问题并提高稳定性
- ✨（这个符号在中文里通常表示“闪亮”、“闪耀”或用来表达某种积极、正面的情绪，但没有直接对应的中文词汇，所以在这里保留原样或根据上下文可译为“闪闪发光”等） 新功能 - 添加新工具或增强现有工具
- 📖（表示一本书或阅读的标志） 文档 - 改进指南和示例
- 🧪 表示“实验”或“化学实验”的符号。 测试 - 增加或提高测试覆盖率
- 🔄（循环/旋转） 数据更新 - 保持对Mindvalley信息的更新
📊 数据来源
所有数据均来源于公开的Mindvalley信息，并存储于 src/resources/mindvalley_data.json数据包括：
- 产品官方定价和结账网址
- 大师班当前提供的免费大师班课程
- 程序/项目（根据上下文，"Programs" 可以翻译为“程序”或“项目”，这里提供了两种可能的翻译）分类学习内容
- 认证专业认证项目
注数据为静态数据，需手动更新。如需获取最新信息，请始终以官方Mindvalley来源为准。
🛡️ 安全与隐私
- 没有API密钥无需外部API调用或身份验证
- 仅公开数据仅包含公开信息
- 无用户数据不收集或存储任何个人信息
- 安全操作所有工具均为只读且非破坏性
出于安全考虑，请参阅我们的 安全策略。
📄 许可证
这个项目采用MIT许可证授权——详见 许可证 详情请参阅文件。
🔗 链接
- NPM 包https://www.npmjs.com/package/mindvalley-products-mcp 的中文翻译可以是：“https://www.npmjs.com/ 上的 mindvalley-products-mcp 包” 或者更简洁地表述为 “NPM 上的 mindvalley-products-mcp 包”
- GitHub 仓库https://github.com/mazemax/mindvalley-products-mcp 的中文翻译可以是：“https://github.com 上的 mazemax/mindvalley-products-mcp 项目” 或者简化为 “mazemax 在 GitHub 上的 mindvalley-products-mcp 项目”。不过，具体翻译可能会根据上下文和使用场景有所调整。在这里，我提供了较为通用的翻译版本
- 问题跟踪器https://github.com/mazemax/mindvalley-products-mcp/issues 的中文翻译是：“GitHub 上的 mazemax/mindvalley-products-mcp 项目的问题页面”
- MCP协议https://modelcontextprotocol.io（该网址可直接翻译为“模型上下文协议.io”，但通常网址不进行具体翻译，保持原样即可）
- 心智谷（或译为“思维谷”）https://www.mindvalley.com 翻译为中文是：“https://www.心灵山谷.com”（注：实际翻译时，网址通常保持原样，不进行翻译，但在这里为了符合中文表达习惯，对域名部分进行了意译，实际使用中应保留原网址）。不过，更准确的做法是直接保留网址不变，因为网址是特定的网络地址，不具有翻译的必要性。所以，最直接的翻译就是保留原网址
🙏 致谢
- 模型上下文协议 - 对于出色的协议规范
- XMCP框架 - 对于开发框架
- Mindvalley（心灵山谷） - 对于教育内容（这是一个非官方项目）
- 社区 - 用于反馈、贡献和支持
______________________________________________________________________
由……用心制作 马克斯·萨德
_这是一个非官方项目，与Mindvalley无任何隶属关系，也未得到其认可。_