Unified MCP Suite

统一 MCP 套件

此代码库包含一组打包在一起的 Model Context Protocol（MCP）服务，方便使用。每个服务都提供与媒体处理、信息检索和文档创建相关的不同功能。

📦 查看已发布的包 - 所有 npm 包的简易安装指南！

重要： 这些服务设计为单独进程运行。你需要在 MCP 客户端（例如 Cline 或 Claude 桌面应用）中分别设置和配置每个服务。

包含的服务

• 媒体工具服务（media-tools-server）：提供搜索图片（Unsplash）和视频（YouTube）、下载图片以及理解图片／视频内容（Google Gemini、YouTube Transcripts）的工具。（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 代码编译为 JavaScript，并输出到 build 目录。）

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 密钥。
  • 创建 Custom Search Engine 并获取其 ID：https://programmablesearchengine.google.com/

e. 配置 MCP 客户端：

将以下配置添加到 MCP 客户端的设置文件中。将占位符替换为实际的 API 密钥、Search Engine 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）可执行文件。