mindvalley-products-mcp

Mindvalley Products MCP 服务

一个 Model Context Protocol (MCP) 服务，为 AI 助手提供对 Mindvalley 教育产品的结构化访问，包括产品、大师班、课程和认证。

✨ 功能

• 🚀 4 个 MCP 工具 - 访问产品、大师班、课程和认证
• 🔒 只读且安全 - 使用静态数据执行非破坏性操作
• ⚡ 高性能 - 无需调用外部 API，即时响应
• 🎯 智能筛选 - 提供可选参数，实现有针对性的查询
• 🔧 轻松集成 - 兼容 Claude Desktop、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 Desktop 中使用

1. 添加到 Claude Desktop 配置（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "mindvalley-products": {
      "command": "npx",
      "args": ["mindvalley-products-mcp"]
    }
  }
}

2. 重启 Claude Desktop，然后开始提问，例如：
   • “Mindvalley 提供哪些产品？”
   • “给我看看 Jim Kwik 主讲的大师班”
   • “Mind 类别下有哪些课程？”

🛠️ 可用工具

1. products - Mindvalley 核心产品

获取 Mindvalley 订阅产品和定价信息。

// Get all products
products();

// Get specific product
products({ name: "Mindvalley Membership" });

响应包含：产品名称、描述、价格（月付/年付）、结账 URL

2. masterclasses - 免费大师班

查看当前 Mindvalley 大师班及其注册链接。

// Get all masterclasses
masterclasses();

// Filter by title
masterclasses({ title: "Superbrain" });

响应包含：大师班标题、主持人、描述、注册链接

3. programs - 教育课程

按类别浏览 Mindvalley 的学习课程。

// Get all programs (by category)
programs();

// Get programs in specific category
programs({ category: "Mind" });

可用类别：思维、身体、灵魂、职业、创业、人际关系、育儿

4. certifications - 教练认证

了解 Mindvalley 的专业认证信息。

// Get all certifications
certifications();

// Filter by name
certifications({ name: "Life Coach" });

响应包含：认证名称、提供方、时长、要求、报名 URL

📖 集成指南

Claude Desktop

详细设置指南：examples/claude-desktop/README.md

Cursor IDE

集成说明：examples/cursor/README.md

自定义 MCP 客户端

编程使用示例：examples/mcp-client/README.md

💡 用例示例

个人学习规划

用户：“我想提升记忆力和专注力。Mindvalley 有什么内容？”

AI 响应：根据你的兴趣，我找到了几个相关选项：

大师班（免费）：Jim Kwik 主讲的 Superbrain 大师班——“释放你的记忆力与大脑潜能”

课程：Jim Kwik 的 Superbrain——全面提升记忆力的课程

其他相关内容：职业类别下 Nir Eyal 的“变得专注且不再分心”

产品对比

用户：“比较一下 Mindvalley Membership 和 Membership Pro”

AI 响应：以下是对比：

Mindvalley Membership（每年 $499 或每月 $99）

• 可无限访问 100 多个 quests 和冥想内容的订阅

Mindvalley Membership Pro（仅提供年付，$698/年）

• 包含 Membership 的所有内容，另加实时教练课程
• 每年额外支付 $199，即可参加实时教练课程

认证研究

用户：“我想成为一名认证教练。Mindvalley 有哪些选择？”

AI 回复：Mindvalley 通过 Evercoach 提供多种教练认证课程：

认证人生教练（4 个月）——200 美元可退还押金 认证商业教练（4 个月）——面向企业／高管教练 认证催眠治疗师（16 周）——由 Paul McKenna 主讲

🔧 开发

本地开发

# 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

添加新工具

1. 在 src/tools/ 中创建新文件
2. 导出 schema、metadata 和默认函数
3. 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')))"

🤝 参与贡献

欢迎参与贡献！详情请参阅我们的贡献指南。

快速贡献步骤

1. Fork 此存储库
2. 创建功能分支：git checkout -b feature/amazing-feature
3. 进行更改并添加测试
4. 运行测试：pnpm test
5. 提交：git commit -m 'Add amazing feature'
6. 推送：git push origin feature/amazing-feature
7. 创建 Pull Request

贡献类型

• 🐛 错误修复——修复问题并提高稳定性
• ✨ 新功能——添加新工具或增强现有工具
• 📖 文档——改进指南和示例
• 🧪 测试——增加或改进测试覆盖率
• 🔄 数据更新——及时更新 Mindvalley 信息

📊 数据来源

所有数据均来自公开的 Mindvalley 信息，并存储在 src/resources/mindvalley_data.json 中。数据包括：

• 产品：官方定价和结账 URL
• 大师班：当前提供的免费大师班
• 课程：分类整理的学习内容
• 认证：专业认证课程

注意：数据为静态数据，需手动更新。如需获取最新信息，请务必向 Mindvalley 官方渠道核实。

🛡️ 安全与隐私

• 无需 API 密钥：不调用外部 API，也无需身份验证
• 仅含公开数据：仅包含公开可用的信息
• 不收集用户数据：不会收集或存储个人信息
• 安全操作：所有工具均为只读，不会造成破坏

如有安全问题，请参阅我们的安全策略。

📄 许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

🔗 链接

• NPM 包：https://www.npmjs.com/package/mindvalley-products-mcp
• GitHub 存储库：https://github.com/mazemax/mindvalley-products-mcp
• 问题跟踪器：https://github.com/mazemax/mindvalley-products-mcp/issues
• MCP 协议：https://modelcontextprotocol.io
• Mindvalley：https://www.mindvalley.com

🙏 致谢

• Model Context Protocol——感谢提供出色的协议规范
• XMCP Framework——感谢提供开发框架
• Mindvalley——感谢提供教育内容（这是一个非官方项目）
• 社区——感谢提供反馈、贡献和支持

---

由 Max Saad 用 ❤️ 倾情打造

这是一个非官方项目，与 Mindvalley 无关联，也未获其认可。