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 沒有關聯，也未得到其認可。