mindvalley-products-mcp

Mindvalley Products MCP サーバー

Mindvalleyの教育コンテンツ（製品、マスタークラス、プログラム、認定資格など）に、AI アシスタントが構造化された形でアクセスできるようにする Model Context Protocol（MCP）サーバーです。

✨ 特長

• 🚀 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" });

応答内容：マスタークラスのタイトル、講師、説明、登録URL

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 Masterclass —「記憶力と脳の力を引き出す」

プログラム：Jim KwikによるSuperbrain — 記憶力向上のための総合プログラム

関連コンテンツ：キャリアカテゴリーにある、Nir Eyalによる「集中力を高め、気が散らない自分になる」

製品の比較

ユーザー：「Mindvalley MembershipとMembership Proを比較して」

AIの応答：比較結果はこちらです。

Mindvalley Membership（年額$499、または月額$99）

• 100以上のクエストと瞑想を利用できるオールアクセスのサブスクリプション

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

🔍 トラブルシューティング

よくある問題

❌ "Command not found: mindvalley-products-mcp"

# Verify installation
npm list -g mindvalley-products-mcp

# Reinstall if needed
npm install -g mindvalley-products-mcp

❌ "Server failed to start"

# 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

❌ "Tools not available in AI assistant"

• 設定を変更した後、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. リポジトリをフォークします
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. プルリクエストを作成します

貢献の種類

• 🐛 バグ修正 - 問題を解決し、安定性を向上させます
• ✨ 新機能 - 新しいツールを追加するか、既存のツールを強化します
• 📖 ドキュメント - ガイドや例を改善します
• 🧪 テスト - テストカバレッジを追加または改善します
• 🔄 データの更新 - 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と提携しておらず、Mindvalleyによる推奨も受けていません。