jdjr2024/markdownify-mcp-utf8

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

15 stars 8 forks 品質 61 トレンド 21MIT

Repository Install

MCP Markdownify Server with UTF-8 Support - Enhanced version with better multilingual handling

概要

This is an enhanced version of the original Markdownify MCP project, with improved UTF-8 encoding support and optimized handling of multilingual content. - Added comprehensive UTF-8 encoding support - Optimized handling of multilingual content - Fixed encoding issues on Windows systems - Improved error handling mechanisms 1. Enhanced Encoding Support: - Full UTF-8 support across all operations - Proper handling of Chinese, Japanese, Korean and other non-ASCII characters - Fixed Windows-specific encoding issues (cmd.exe and PowerShell compatibility) 2. Improved Error Handling: - Detailed error messages in both English and Chinese - Better exception handling for network issues - Graceful fallback mechanisms for conversion failures 3. Extended Functionality: - Added support for batch processing multiple files - Enhanced YouTube video transcript handling - Improved metadata extraction from various file formats - Better preservation of document formatting 4.

README

以下は原文 README の抜粋です。原文を見る。

Markdownify MCP Server - UTF-8 Enhanced

This is an enhanced version of the original Markdownify MCP project, with improved UTF-8 encoding support and optimized handling of multilingual content.

中文文档

Enhancements

Added comprehensive UTF-8 encoding support
Optimized handling of multilingual content
Fixed encoding issues on Windows systems
Improved error handling mechanisms

Key Differences from Original Project

Enhanced Encoding Support:
- Full UTF-8 support across all operations
- Proper handling of Chinese, Japanese, Korean and other non-ASCII characters
- Fixed Windows-specific encoding issues (cmd.exe and PowerShell compatibility)
Improved Error Handling:
- Detailed error messages in both English and Chinese
- Better exception handling for network issues
- Graceful fallback mechanisms for conversion failures
Extended Functionality:
- Added support for batch processing multiple files
- Enhanced YouTube video transcript handling
- Improved metadata extraction from various file formats
- Better preservation of document formatting
Performance Optimizations:
- Optimized memory usage for large file conversions
- Faster processing of multilingual content
- Reduced dependency conflicts
Better Development Experience:
- Comprehensive debugging options
- Detailed logging system
- Environment-specific configuration support
- Clear documentation in both English and Chinese

Features

Supports converting various file types to Markdown:

PDF files
Images (with metadata)
Audio (with transcription)
Word documents (DOCX)
Excel spreadsheets (XLSX)
PowerPoint presentations (PPTX)
Web content:
- YouTube video transcripts
- Search results
- General web pages
Existing Markdown files

Quick Start

Clone this repository:

git clone https://github.com/JDJR2024/markdownify-mcp-utf8.git
cd markdownify-mcp-utf8

Install dependencies:
```
pnpm install
```
Note: This will also install uv and related Python dependencies.
Build the project:
```
pnpm run build
```
Start the server:
```
pnpm start
```

Requirements

Node.js 16.0 or higher
Python 3.8 or higher
pnpm package manager
Git

Detailed Installation Guide

1. Environment Setup

Install Node.js:
- Download from Node.js official website
- Verify installation: node --version
Install pnpm:
```
npm install -g pnpm
pnpm --version
```
Install Python:
- Download from Python official website
- Ensure Python is added to PATH during installation
- Verify installation: python --version

(Windows Only) Configure UTF-8 Support:

# Set system-wide UTF-8
setx PYTHONIOENCODING UTF-8
# Set current session UTF-8

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE_PATH}/dist/index.js"
      ],
      "env": {
        "UV_PATH": "/path/to/uv"
      }
    }
  }
}