Unified MCP Suite

統合 MCP スイート

このリポジトリには、使いやすいようにまとめられた Model Context Protocol（MCP）サーバーのコレクションが含まれています。各サーバーは、メディアの取り扱い、情報検索、ドキュメント作成に関するさまざまな機能を提供します。

📦 公開パッケージを見る - すべての npm パッケージの簡単なインストールガイドです！

重要： これらのサーバーは、個別のプロセスとして実行するように設計されています。MCP クライアント（Cline や Claude デスクトップアプリなど）内で、各サーバーを個別にセットアップして設定する必要があります。

含まれるサーバー

• メディアツールサーバー（media-tools-server）：画像（Unsplash）や動画（YouTube）の検索、画像のダウンロード、画像／動画の内容の理解（Google Gemini、YouTube トランスクリプト）を行うツールを提供します。（Node.js/TypeScript）
• 情報検索サーバー（information-retrieval-server）：ウェブ検索（Google Custom Search）やウェブページのクロールを行うツールを提供します。（Node.js/TypeScript）
• PDF 作成サーバー（pdf-creator-server）：Playwright と Pillow を使用して、HTML コンテンツから PDF ドキュメントを生成するツールを提供します。（Python）
• プレゼンテーション作成サーバー（presentation-creator-server）：HTML スライドコンテンツから PowerPoint プレゼンテーションを作成し、HTML から PDF を生成するツールを提供します。（Python）

クイックスタート（推奨）

これらの MCP サーバーを使用する最も簡単な方法は、npm パッケージを利用することです。クローンやビルドは不要です！

公開パッケージ

すべての TypeScript/Node.js サーバーが npm で利用できるようになりました：

• information-retrieval-mcp-server：ウェブ検索とクロール
• media-tools-mcp-server：画像／動画の検索とメディアの理解
• presentation-creator-mcp-server：HTML からプレゼンテーションと PDF を作成

インストール方法

オプション 1：npx を使用（最も簡単 - インストール不要）

MCP クライアントの設定に追加します（例：claude_desktop_config.json）。

設定ファイルの場所：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "information-retrieval": {
      "command": "npx",
      "args": ["-y", "information-retrieval-mcp-server"],
      "env": {
        "GOOGLE_API_KEY": "your-google-api-key",
        "GOOGLE_CSE_ID": "your-custom-search-engine-id"
      }
    },
    "media-tools": {
      "command": "npx",
      "args": ["-y", "media-tools-mcp-server"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "your-unsplash-key",
        "GEMINI_API_KEY": "your-gemini-key"
      }
    },
    "presentation-creator": {
      "command": "npx",
      "args": ["-y", "presentation-creator-mcp-server"]
    }
  }
}

必要な API キー：

• 情報検索サーバー：
  • Google Custom Search API キー（こちらから取得）
  • Custom Search Engine ID（こちらで作成）
• メディアツールサーバー：
  • Unsplash API キー（こちらから取得）
  • Google Gemini API キー（こちらから取得）
• プレゼンテーション作成サーバー：API キーは不要です

オプション 2：npm のグローバルインストール

npm install -g information-retrieval-mcp-server
npm install -g media-tools-mcp-server
npm install -g presentation-creator-mcp-server

その後、コマンド名だけで設定します：

{
  "mcpServers": {
    "information-retrieval": {
      "command": "information-retrieval-mcp-server",
      "env": { /* ... */ }
    }
  }
}

高度なセットアップ（ソースからビルド）

ソースからビルドする場合や、サーバーを変更する必要がある場合：

1. リポジトリをクローンする

git clone <repository-url> # Replace <repository-url> with the actual URL
cd unified-mcp-suite

2. メディアツールサーバー（media-tools-server）

（Node.js/TypeScript）

a. ディレクトリに移動します：

cd media-tools-server

b. 依存関係をインストールします：

npm install

c. サーバーをビルドします：

npm run build

（TypeScript コードをコンパイルし、build ディレクトリに JavaScript を生成します。）

d. API キーを取得します：

• Unsplash API キー： 画像検索に必要です。アカウントを作成し、https://unsplash.com/developersでアプリケーションを登録してください。
• Google API キー： 動画の検索・理解と画像の理解に必要です。
  • Google Cloud Console プロジェクトで「YouTube Data API v3」と「Vertex AI API」（Gemini 用）を有効にします：https://console.cloud.google.com/
  • 「APIs & Services」→「Credentials」で API キーを作成します。必要に応じてキーを制限してください。

e. MCP クライアントを設定します：

以下の設定を MCP クライアントの設定ファイル（例：cline_mcp_settings.json または claude_desktop_config.json）に追加します。プレースホルダーを実際の API キーと、ビルド済みサーバーファイルの正しい絶対パスに置き換えてください。

{
  "mcpServers": {
    // ... other servers
    "media-tools": {
      "command": "node",
      "args": ["C:/path/to/unified-mcp-suite/media-tools-server/build/index.js"], // <-- UPDATE THIS PATH
      "env": {
        "UNSPLASH_ACCESS_KEY": "YOUR_UNSPLASH_API_KEY", // <-- ADD YOUR KEY
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY"       // <-- ADD YOUR KEY
      },
      "disabled": false, // Set to false to enable
      "autoApprove": []
    }
    // ... other servers
  }
}

f. 戻ります：

cd ..

3. 情報検索サーバー（information-retrieval-server）

（Node.js/TypeScript）

a. ディレクトリに移動します：

cd information-retrieval-server

b. 依存関係をインストールします：

npm install

c. サーバーをビルドします：

npm run build

d. API キーを取得します：

• Google Custom Search API：
  • Google Cloud Console プロジェクトで「Custom Search API」を有効にします：https://console.cloud.google.com/
  • 「APIs & Services」→「Credentials」で API キーを作成します。
  • Programmable Search Engine を作成し、その ID を取得します：https://programmablesearchengine.google.com/

e. MCP クライアントを設定します：

以下の設定を MCP クライアントの設定ファイルに追加します。プレースホルダーを実際の API キー、検索エンジン ID、および正しい絶対パスに置き換えてください。

{
  "mcpServers": {
    // ... other servers
    "information-retrieval": {
      "command": "node",
      "args": ["C:/path/to/unified-mcp-suite/information-retrieval-server/build/index.js"], // <-- UPDATE THIS PATH
      "env": {
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY",             // <-- ADD YOUR KEY
        "GOOGLE_CSE_ID": "YOUR_CUSTOM_SEARCH_ENGINE_ID"  // <-- ADD YOUR ID
      },
      "disabled": false, // Set to false to enable
      "autoApprove": []
    }
    // ... other servers
  }
}

f. 戻ります：

cd ..

4. PDF 作成サーバー（pdf-creator-server）

（Python）

a. ディレクトリに移動します：

cd pdf-creator-server

b. 仮想環境を作成して有効化します：

# Create environment
python -m venv .venv

# Activate environment
# Windows (Command Prompt/PowerShell)
.\.venv\Scripts\activate
# macOS/Linux (bash/zsh)
# source .venv/bin/activate

c. 依存関係をインストールします：

pip install -r requirements.txt

d. Playwright ブラウザーをインストールします：（PDF の生成に必要です）

playwright install

e. MCP クライアントを設定します：

以下の設定を MCP クライアントの設定ファイルに追加します。プレースホルダーを、仮想環境内の Python 実行ファイルとサーバースクリプトの正しい絶対パスに置き換えてください。

{
  "mcpServers": {
    // ... other servers
    "pdf-creator": {
      // UPDATE python path to point to the .venv executable
      "command": "C:/path/to/unified-mcp-suite/pdf-creator-server/.venv/Scripts/python.exe", // Windows example
      // "command": "/path/to/unified-mcp-suite/pdf-creator-server/.venv/bin/python", // macOS/Linux example
      "args": ["C:/path/to/unified-mcp-suite/pdf-creator-server/pdf_creator_server.py"], // <-- UPDATE THIS PATH
      "env": {}, // No specific environment variables needed by default
      "disabled": false, // Set to false to enable
      "autoApprove": []
    }
    // ... other servers
  }
}

f. 仮想環境を無効化します（任意）：

deactivate

g. 戻ります：

cd ..

5. プレゼンテーション作成サーバー（presentation-creator-server）

（Python）

a. ディレクトリに移動します：

cd presentation-creator-server

b. 仮想環境を作成して有効化します：

# Create environment
python -m venv .venv

# Activate environment
# Windows (Command Prompt/PowerShell)
.\.venv\Scripts\activate
# macOS/Linux (bash/zsh)
# source .venv/bin/activate

c. 依存関係をインストールします：

pip install -r requirements.txt

d. Playwright ブラウザーをインストールします：（HTML スライドのスクリーンショット撮影に必要です）

playwright install

e. MCP クライアントを設定します：

以下の設定を MCP クライアントの設定ファイルに追加します。プレースホルダーを、仮想環境内の Python 実行ファイルとサーバースクリプトの正しい絶対パスに置き換えてください。

{
  "mcpServers": {
    // ... other servers
    "presentation-creator": {
      // UPDATE python path to point to the .venv executable
      "command": "C:/path/to/unified-mcp-suite/presentation-creator-server/.venv/Scripts/python.exe", // Windows example
      // "command": "/path/to/unified-mcp-suite/presentation-creator-server/.venv/bin/python", // macOS/Linux example
      "args": ["C:/path/to/unified-mcp-suite/presentation-creator-server/presentation_creator_server.py"], // <-- UPDATE THIS PATH
      "env": {}, // No specific environment variables needed by default
      "disabled": false, // Set to false to enable
      "autoApprove": []
    }
    // ... other servers
  }
}

f. 仮想環境を無効化します（任意）：

deactivate

g. 戻ります：

cd ..

サーバーの実行

MCP クライアントで設定すると、クライアントの起動時にサーバーが自動的に起動します。その後、MCP クライアントのインターフェースから、各サーバーが提供するツールを使用できます。

設定ファイルの例

このリポジトリのルートには、example_cline_mcp_settings.json という設定ファイルの例が含まれています。これをテンプレートとして使用し、MCP クライアント（Cline など）のサーバーを設定できます。

例を使用するには：

1. MCP クライアントの実際の設定ファイルを確認します（例：Windows 上の VS Code で Cline を使用する場合は、c:\Users\YourUser\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json）。
2. example_cline_mcp_settings.json からサーバー設定をコピーし、既存のサーバー設定があれば統合して、実際の設定ファイルに貼り付けます。
3. 重要：すべてのプレースホルダーのパス（例：C:/absolute/path/to/...）を、システム上で unified-mcp-suite リポジトリをクローンした実際の絶対パスに変更してください。
4. すべてのプレースホルダー API キー（例：YOUR_GOOGLE_API_KEY_HERE）を、セットアップ手順で取得したご自身のキーに置き換えてください。
5. Python サーバーの command パスが、作成した各 .venv ディレクトリ内の python.exe（Windows）または python（macOS/Linux）を正しく指していることを確認してください。