Mindvalley Products MCP

🚀 Mindvalley Products MCP 服务器

Mindvalley Products MCP 服务器是一个依据模型上下文协议（MCP）构建的服务器，它为 AI 助手提供了结构化的方式，来访问 Mindvalley 的各类教育资源，涵盖了产品、大师课、学习项目以及认证课程等。

🚀 快速开始

安装

# 全局安装，方便使用
npm install -g mindvalley-products-mcp

# 或者在你的项目中本地安装
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 类别下有哪些学习项目？”

✨ 主要特性

• 🚀 四大 MCP 工具：可访问产品、大师课、学习项目和认证课程。
• 🔒 只读且安全：操作不会对数据造成破坏，使用的是静态数据。
• ⚡ 性能卓越：无需调用外部 API，响应迅速。
• 🎯 智能过滤：支持使用可选参数进行精准查询。
• 🔧 易于集成：可与 Claude Desktop、Cursor IDE 以及自定义客户端配合使用。
• 📚 文档完备：提供全面的示例和使用指南。

📦 安装指南

全局安装

npm install -g mindvalley-products-mcp

项目内本地安装

npm install mindvalley-products-mcp

💻 使用示例

基础用法

1. products - Mindvalley 核心产品

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

// 获取所有产品
products();

// 获取特定产品
products({ name: "Mindvalley Membership" });

响应内容包括：产品名称、描述、价格（月付/年付）、结账链接。

2. masterclasses - 免费大师课

访问当前 Mindvalley 的大师课及其注册链接。

// 获取所有大师课
masterclasses();

// 按标题过滤
masterclasses({ title: "Superbrain" });

响应内容包括：大师课标题、主讲人、描述、注册链接。

3. programs - 教育项目

浏览按类别分类的 Mindvalley 学习项目。

// 获取所有项目（按类别）
programs();

// 获取特定类别下的项目
programs({ category: "Mind" });

可用类别：Mind（心智）、Body（身体）、Soul（心灵）、Career（职业）、Entrepreneurship（创业）、Relationships（人际关系）、Parenting（育儿）。

4. certifications - 教练认证

获取 Mindvalley 专业认证的相关信息。

// 获取所有认证
certifications();

// 按名称过滤
certifications({ name: "Life Coach" });

响应内容包括：认证名称、提供商、时长、要求、报名链接。

高级用法

这里可以根据不同工具，编写更复杂的使用场景，例如结合多个过滤条件等，但文档中未给出相关示例，暂不展示。

📚 详细文档

Claude Desktop

详细的设置指南：

Cursor IDE

集成说明：

自定义 MCP 客户端

编程使用示例：

🔧 技术细节

本地开发

# 克隆仓库
git clone https://github.com/mazemax/mindvalley-products-mcp.git
cd mindvalley-products-mcp

# 安装依赖
pnpm install

# 构建服务器
pnpm run build

# 运行测试
pnpm test

# 启动开发模式（支持热更新）
pnpm run dev

项目结构

mindvalley-products-mcp/
├── src/
│   ├── tools/              # MCP 工具实现
│   │   ├── products.ts
│   │   ├── masterclasses.ts
│   │   ├── programs.ts
│   │   └── certifications.ts
│   └── resources/          # 静态数据源
│       └── mindvalley_data.json
├── examples/               # 集成示例
│   ├── claude-desktop/
│   ├── cursor/
│   └── mcp-client/
├── dist/                   # 构建后的服务器文件
└── docs/                   # 额外的文档

添加新工具

1. 在 src/tools/ 目录下创建新文件。
2. 导出 schema、metadata 和默认函数。

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) }] };
}

🔍 故障排除

常见问题

❌ “Command not found: mindvalley-products-mcp”

# 验证安装情况
npm list -g mindvalley-products-mcp

# 如有需要，重新安装
npm install -g mindvalley-products-mcp

❌ “Server failed to start”

# 检查 Node.js 版本（需要 >=20.0.0）
node --version

# 直接测试服务器
npx mindvalley-products-mcp

# 检查 AI 助手日志中的错误信息

❌ “Tools not available in AI assistant”

• 配置更改后，重启 AI 助手。
• 验证 MCP 配置文件的 JSON 语法。
• 检查服务器路径是否正确。

服务器测试

在集成之前，独立测试服务器：

# 测试服务器是否能正常启动
npx mindvalley-products-mcp

# 运行测试套件
cd examples/mcp-client
node example.js

配置验证

验证 MCP 配置：

# 检查 Claude Desktop 配置
cat "~/Library/Application Support/Claude/claude_desktop_config.json" | jq

# 测试配置语法
node -e "console.log(JSON.parse(require('fs').readFileSync('config.json')))"

🤝 贡献代码

我们欢迎大家贡献代码！详细信息请参考 贡献指南。

快速贡献步骤

1. 分叉仓库。
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. 发起拉取请求。

贡献类型

• 🐛 修复 Bug：修复问题，提高稳定性。
• ✨ 新增功能：添加新工具或增强现有功能。
• 📖 完善文档：改进使用指南和示例。
• 🧪 补充测试：增加或改进测试覆盖范围。
• 🔄 更新数据：保持 Mindvalley 信息的时效性。

📊 数据源

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

• 产品：官方定价和结账链接。
• 大师课：当前的免费大师课信息。
• 学习项目：按类别分类的学习内容。
• 认证课程：专业认证项目。

⚠️ 重要提示

数据是静态的，需要手动更新。如需获取最新信息，请始终以 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 没有关联，也未得到其认可。