Mindvalley Products MCP

🚀 Mindvalley Products MCP Server

Mindvalley Products MCP Serverは、AIアシスタントに対して、Mindvalleyの教育コンテンツ（製品、マスタークラス、プログラム、認定資格など）に構造化されたアクセスを提供するModel Context Protocol (MCP) サーバーです。

🚀 クイックスタート

インストール

# グローバルにインストールして簡単にアクセスできるようにする
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カテゴリのプログラムはどれですか？"

✨ 主な機能

• 🚀 4つのMCPツール - 製品、マスタークラス、プログラム、認定資格にアクセスできます。
• 🔒 読み取り専用で安全 - 静的データを使用した非破壊的な操作です。
• ⚡ 高速なパフォーマンス - 外部API呼び出しがなく、即座に応答します。
• 🎯 スマートなフィルタリング - ターゲットに絞ったクエリを行うためのオプションパラメータがあります。
• 🔧 簡単な統合 - Claude Desktop、Cursor IDE、およびカスタムクライアントと連携します。
• 📚 完全なドキュメント - 包括的なサンプルとガイドが用意されています。

💻 使用例

基本的な使用法

// すべての製品を取得
products();

// 特定の製品を取得
products({ name: "Mindvalley Membership" });

高度な使用法

// すべてのマスタークラスを取得
masterclasses();

// タイトルでフィルタリング
masterclasses({ title: "Superbrain" });

📚 ドキュメント

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、およびデフォルト関数をエクスポートします。
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"

# インストールを確認する
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')))"

🤝 コントリビューション

コントリビューションを歓迎します！詳細については、Contributing Guide を参照してください。

コントリビューションの手順

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呼び出しや認証が必要ありません。
• 公開データのみ - 公開されている情報のみを含んでいます。
• ユーザーデータなし - 個人情報は収集または保存されません。
• 安全な操作 - すべてのツールは読み取り専用で非破壊的です。

セキュリティに関する懸念事項については、Security Policy を参照してください。

📄 ライセンス

このプロジェクトは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 - 教育コンテンツを提供してくれました（これは非公式プロジェクトです）。
• コミュニティ - フィードバック、コントリビューション、サポートをしてくれました。

Made with ❤️ by Max Saad

これは非公式のプロジェクトであり、Mindvalleyとは関係がなく、承認もされていません。