使用说明

项目简介

Useful MCPS 是一个 Model Context Protocol (MCP) 服务器集合，旨在为AI助手提供各种实用工具，扩展其功能。该仓库包含多个独立的 Python 脚本，每个脚本实现一个特定的 MCP 服务器，提供专门的工具集。

主要功能点

YouTube Data Extractor: 从 YouTube 视频中提取信息，包括章节和字幕。
Word Document Processor: 处理 Word 文档，支持模板占位符替换、内容块管理和转换为 PDF 格式。
PlantUML Renderer: 渲染 PlantUML 图表，需要预先部署 PlantUML 服务器（例如通过 Docker）。
Mermaid Renderer: 渲染 Mermaid 图表，使用 mermaidchart.com API 服务。

安装步骤

克隆仓库

git clone https://github.com/daltonnyx/userful-mcps.git
cd useful-mcps

安装 'uv'
```
pip install uv
```
或者参考 uv GitHub 仓库的安装说明。
安装依赖 每个 MCP 服务器的依赖都在各自目录下的 'pyproject.toml' 文件中管理。首次运行 'uv run' 命令时，会自动安装依赖。

服务器配置

以下是 MCP 客户端配置 'mcpServers' 字段的示例，用于配置连接到本仓库提供的各个 MCP 服务器。请根据需要配置到你的 MCP 客户端。

YouTube Data Extractor 配置

"mcpServers": {
  "ytdlp": {
    "name": "youtube",
    "command": "uv",
    "args": [
      "run",
      "--directory", "<path/to/repo>/useful-mcps/ytdlp", // 将 &lt;path/to/repo&gt; 替换为 userful-mcps 仓库在您本地的实际路径
      "--",
      "ytdlp_mcp"
    ]
  }
}

Word Document Processor 配置

"mcpServers": {
  "docx_replace": {
    "name": "docx",
    "command": "uv",
    "args": [
      "run",
      "--directory", "<path/to/repo>/useful-mcps/docx_replace", // 将 &lt;path/to/repo&gt; 替换为 userful-mcps 仓库在您本地的实际路径
      "--",
      "docx_replace_mcp"
    ]
  }
}

PlantUML Renderer 配置 (需要预先运行 PlantUML 服务器)

"mcpServers": {
  "plantuml": {
    "name": "plantuml",
    "command": "uv",
    "args": [
      "run",
      "--directory", "<path/to/repo>/useful-mcps/plantuml", // 将 &lt;path/to/repo&gt; 替换为 userful-mcps 仓库在您本地的实际路径
      "--",
      "plantuml_server"
    ]
  }
}

Mermaid Renderer 配置 (需要设置 Mermaid Chart API 访问令牌环境变量 'MERMAID_CHART_ACCESS_TOKEN')

"mcpServers": {
  "mermaid": {
    "name": "mermaid",
    "command": "uv",
    "args": [
      "run",
      "--directory", "<path/to/repo>/useful-mcps/mermaid", // 将 &lt;path/to/repo&gt; 替换为 userful-mcps 仓库在您本地的实际路径
      "--",
      "mermaid_mcp"
    ],
    "env": {
      "MERMAID_CHART_ACCESS_TOKEN": "YOUR_API_TOKEN_HERE" // 将 YOUR_API_TOKEN_HERE 替换为您的 Mermaid Chart API 访问令牌
    }
  }
}

基本使用方法

确保已安装 'uv' 并克隆了仓库。
根据需要配置你的 MCP 客户端，将上述相应的服务器配置添加到客户端的 'mcpServers' 配置中，并更新 '<path/to/repo>' 为仓库的实际本地路径，以及 Mermaid Renderer 的 API 令牌。
客户端启动后，即可通过 MCP 协议与这些服务器进行通信，调用它们提供的工具。
具体工具的使用方法和参数，请参考仓库 'README.md' 文件中 "Tool-Specific Usage Examples" 部分的说明，以及每个 MCP 服务器目录下的 'README.md' 或代码注释。

关键词