统一 MCP 套件

此仓库包含一系列模型上下文协议 (MCP) 服务器，为了方便起见打包在一起。每个服务器提供与媒体处理、信息检索和文档创建相关的不同功能。

重要提示： 这些服务器设计为作为单独的进程运行。您需要在 MCP 客户端（例如 Cline 或 Claude Desktop App）中单独设置和配置每个服务器。

包含的服务器

• 媒体工具服务器 (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)

前提条件

• Node.js 和 npm: media-tools-server 和 information-retrieval-server 需要。从 https://nodejs.org/ 下载
• Python 和 pip: pdf-creator-server 和 presentation-creator-server 需要。从 https://www.python.org/ 下载
• Git: 用于克隆此仓库。
• MCP 客户端: 能够运行 MCP 服务器的应用程序（例如 Cline、Claude Desktop App）。

安装说明

按照以下步骤操作，为您希望使用的每个服务器进行设置。

1. 克隆仓库

git clone <repository-url> # 将 <repository-url> 替换为实际 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/
  • 在“API 和服务”->“凭据”下创建一个 API 密钥。如有必要，限制密钥。

e. 配置 MCP 客户端：

将以下配置添加到 MCP 客户端的设置文件（例如，cline_mcp_settings.json 或 claude_desktop_config.json）。将占位符替换为您的实际 API 密钥和已构建服务器文件的正确绝对路径。

{
  "mcpServers": {
    // ... 其他服务器
    "media-tools": {
      "command": "node",
      "args": ["C:/path/to/unified-mcp-suite/media-tools-server/build/index.js"], // <-- 更新此路径
      "env": {
        "UNSPLASH_ACCESS_KEY": "YOUR_UNSPLASH_API_KEY", // <-- 添加您的密钥
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY"       // <-- 添加您的密钥
      },
      "disabled": false, // 设置为 false 以启用
      "autoApprove": []
    }
    // ... 其他服务器
  }
}

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/
  • 在“API 和服务”->“凭据”下创建一个 API 密钥。
  • 创建一个 Custom Search Engine 并获取其 ID：https://programmablesearchengine.google.com/

e. 配置 MCP 客户端：

将以下配置添加到 MCP 客户端的设置文件。将占位符替换为您的实际 API 密钥、Search Engine ID 和正确的绝对路径。

{
  "mcpServers": {
    // ... 其他服务器
    "information-retrieval": {
      "command": "node",
      "args": ["C:/path/to/unified-mcp-suite/information-retrieval-server/build/index.js"], // <-- 更新此路径
      "env": {
        "GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY",             // <-- 添加您的密钥
        "GOOGLE_CSE_ID": "YOUR_CUSTOM_SEARCH_ENGINE_ID"  // <-- 添加您的 ID
      },
      "disabled": false, // 设置为 false 以启用
      "autoApprove": []
    }
    // ... 其他服务器
  }
}

f. 返回导航：

cd ..

4. PDF 创建器服务器 (pdf-creator-server)

(Python)

a. 导航到目录：

cd pdf-creator-server

b. 创建并激活虚拟环境：

# 创建环境
python -m venv .venv

# 激活环境
# Windows (命令提示符/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": {
    // ... 其他服务器
    "pdf-creator": {
      // 更新 python 路径以指向 .venv 可执行文件
      "command": "C:/path/to/unified-mcp-suite/pdf-creator-server/.venv/Scripts/python.exe", // Windows 示例
      // "command": "/path/to/unified-mcp-suite/pdf-creator-server/.venv/bin/python", // macOS/Linux 示例
      "args": ["C:/path/to/unified-mcp-suite/pdf-creator-server/pdf_creator_server.py"], // <-- 更新此路径
      "env": {}, // 默认情况下不需要特定的环境变量
      "disabled": false, // 设置为 false 以启用
      "autoApprove": []
    }
    // ... 其他服务器
  }
}

f. 停用虚拟环境（可选）：

deactivate

g. 返回导航：

cd ..

5. 演示文稿创建器服务器 (presentation-creator-server)

(Python)

a. 导航到目录：

cd presentation-creator-server

b. 创建并激活虚拟环境：

# 创建环境
python -m venv .venv

# 激活环境
# Windows (命令提示符/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": {
    // ... 其他服务器
    "presentation-creator": {
      // 更新 python 路径以指向 .venv 可执行文件
      "command": "C:/path/to/unified-mcp-suite/presentation-creator-server/.venv/Scripts/python.exe", // Windows 示例
      // "command": "/path/to/unified-mcp-suite/presentation-creator-server/.venv/bin/python", // macOS/Linux 示例
      "args": ["C:/path/to/unified-mcp-suite/presentation-creator-server/presentation_creator_server.py"], // <-- 更新此路径
      "env": {}, // 默认情况下不需要特定的环境变量
      "disabled": false, // 设置为 false 以启用
      "autoApprove": []
    }
    // ... 其他服务器
  }
}

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) 可执行文件。