Poeditor MCP

🚀 🌐 POEditor MCP Server

POEditor MCP Server 是一個全面的模型上下文協議（MCP）服務器，專為 POEditor 翻譯管理而設計，具備先進的自動化腳本和工作流優化工具，能有效提升翻譯管理的效率和質量。

🚀 快速開始

1. 自動設置（推薦）

# 克隆倉庫
git clone https://github.com/yourusername/poeditor-mcp.git
cd poeditor-mcp

# 運行自動設置腳本
python setup.py

# 按照交互式提示配置你的 POEditor API 令牌

2. 手動設置

# 安裝依賴項
pip install -r requirements.txt

# 複製環境模板
cp .env.template .env

# 使用你的 POEditor API 令牌編輯 .env 文件
nano .env

# 測試連接
python test_connection.py

3. 開始使用

# 顯示所有可用命令
python control_center.py help

# 運行每日監控
python control_center.py monitor

# 生成進度報告
python control_center.py daily_report

# 啟動自動調度
python control_center.py schedule start

✨ 主要特性

• 🔌 完整的 MCP 服務器：與 POEditor API 完全集成。
• 🎛️ 控制中心：主腳本，用於管理所有自動化工具。
• 📊 智能報告：帶有進度跟蹤的交互式 HTML 報告。
• 🚨 監控系統：自動警報，用於檢測翻譯問題。
• 🤖 AI 自動化：智能翻譯建議和一致性檢查。
• 📧 通知：通過電子郵件和 Slack 集成向團隊更新信息。
• 📦 批量導出：多格式導出系統，適用於所有平臺。
• 🕒 調度器：具有類似 cron 功能的自動任務執行。

🎯 為何選擇此 MCP？

與其他需要複雜 Docker 設置的 MCP 服務器不同，POEditor MCP 設計簡潔：

• ❌ 無需 Docker - 純 Python 實現。
• 🎯 專注於翻譯 - 專為本地化工作流而構建。
• 🔧 最少的設置 - 只需添加你的 API 令牌並運行。
• 🚀 即時執行 - python setup.py && python control_center.py。
• 📊 可視化報告 - 漂亮的 HTML 儀表盤。
• 🤖 內置 AI - 智能翻譯建議。

📊 項目狀態

💻 使用示例

基礎用法

from mcp_poeditor.server import call_tool

# 列出所有項目
projects = await call_tool("list_projects", {})

# 獲取項目語言
languages = await call_tool("list_languages", {"project_id": "123456"})

# 搜索特定術語
results = await call_tool("search_terms", {
    "project_id": "123456",
    "search_query": "login"
})

# 導出翻譯
export_url = await call_tool("export_translations", {
    "project_id": "123456",
    "language_code": "es",
    "file_format": "json"
})

自動化工作流

# 早上例行操作
python control_center.py monitor        # 檢查問題
python control_center.py daily_report   # 生成進度報告

# 開發工作流
python control_center.py automate       # 獲取 AI 建議
python control_center.py export         # 為開發人員導出

# 每週優化
python control_center.py optimize       # 分析工作流效率
python control_center.py sync          # 同步相關項目

與 CI/CD 集成

# GitHub Actions 示例
name: Translation Export
on:
  schedule:
    - cron: '0 8 * * *'  # 每天早上 8 點
  
jobs:
  export:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.9'
      - name: Install dependencies
        run: pip install -r requirements.txt
      - name: Export translations
        env:
          POEDITOR_API_TOKEN: ${{ secrets.POEDITOR_API_TOKEN }}
        run: python control_center.py export

📚 詳細文檔

• 📖 安裝指南 - 詳細的設置說明
• ⚙️ 配置指南 - 高級配置選項
• 🔧 API 參考 - 完整的 API 文檔
• 🚀 集成指南 - 平臺集成示例
• 🤝 貢獻指南 - 如何為項目做出貢獻

🔧 技術細節

MCP 客戶端配置

安裝完成後，配置你的 MCP 客戶端以使用 POEditor 服務器：

🎯 Claude Desktop

將此配置添加到你的 Claude Desktop 配置文件中： macOS/Linux：~/.claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "poeditor": {
      "command": "python",
      "args": ["-m", "mcp_poeditor"],
      "cwd": "/path/to/your/poeditor-mcp",
      "env": {
        "POEDITOR_API_TOKEN": "your_poeditor_token_here"
      }
    }
  }
}

🔧 Visual Studio Code

將此配置添加到你的 VS Code 設置中： 文件：.vscode/settings.json（工作區）或用戶設置

{
  "mcp.servers": {
    "poeditor": {
      "command": "python",
      "args": ["-m", "mcp_poeditor"],
      "cwd": "/path/to/your/poeditor-mcp",
      "env": {
        "POEDITOR_API_TOKEN": "your_poeditor_token_here"
      }
    }
  }
}

📝 配置說明

• 將 /path/to/your/poeditor-mcp 替換為你實際的安裝路徑。
• 將 your_poeditor_token_here 替換為你實際的 POEditor API 令牌。
• 配置完成後重啟你的 MCP 客戶端。
• 使用提供的示例文件：claude_desktop_config_example.json 和 vscode_settings_example.json。

🛠️ 可用工具

MCP 服務器通過以下工具類別提供全面的 POEditor 管理：

📋 項目管理

• list_projects - 列出所有項目
• get_project - 獲取項目詳細信息
• create_project - 創建新項目

🌍 語言管理

• list_languages - 列出項目語言
• add_language - 向項目添加語言
• remove_language - 從項目中移除語言

🔍 術語管理

• list_terms - 列出項目術語
• search_terms - 按鍵/值搜索術語
• add_terms - 添加新術語
• delete_terms - 移除術語

✏️ 翻譯管理

• list_translations - 獲取語言翻譯
• add_translation - 添加新翻譯
• update_translation - 更新現有翻譯
• export_translations - 以多種格式導出

📊 統計與分析

• get_project_stats - 項目統計信息
• get_translation_progress - 按語言顯示進度
• compare_languages - 語言比較分析

🎛️ 自動化腳本

項目包含一套強大的自動化腳本，可通過控制中心訪問：

python control_center.py <command>

📊 報告與分析

• daily_report - 生成全面的 HTML 進度報告
• status - 檢查系統健康狀況和配置

🚨 監控與警報

• monitor - 掃描翻譯問題和質量問題
• test - 運行系統診斷

🤖 自動化

• automate - 基於 AI 的翻譯建議和一致性檢查
• schedule - 自動任務調度和執行

📈 優化

• optimize - 工作流分析並提供可操作的建議
• sync - 在類似項目之間同步翻譯

📦 導出與集成

• export - 以多種格式（JSON、Android XML、iOS Strings 等）批量導出
• notify - 通過電子郵件/Slack 發送團隊通知

🔧 管理

• setup - 交互式環境配置
• demo - 完整的系統演示

📁 項目結構

poeditor-mcp/
├── 📄 README.md                     # 本文件
├── 📄 requirements.txt              # Python 依賴項
├── 📄 .env.template                 # 環境模板
├── 📄 setup.py                      # 自動設置腳本
├── 📄 test_connection.py            # 連接測試工具
├── 📄 claude_desktop_config_example.json # Claude Desktop 配置示例
├── 📄 vscode_settings_example.json # VS Code 配置示例
├── 📄 CONFIG_README.md             # 配置指南
│
├── 📁 mcp_poeditor/                # 核心 MCP 包
│   ├── 📄 __init__.py
│   ├── 📄 __main__.py              # 入口點
│   ├── 📄 server.py                # MCP 服務器實現
│   ├── 📄 poeditor_client.py       # POEditor API 客戶端
│   │
│   ├── 📁 tools/                   # MCP 工具
│   │   ├── 📄 projects.py          # 項目管理
│   │   ├── 📄 languages.py         # 語言管理
│   │   ├── 📄 terms.py             # 術語管理
│   │   ├── 📄 translations.py      # 翻譯管理
│   │   └── 📄 stats.py             # 統計與分析
│   │
│   └── 📁 utils/                   # 實用工具
│       ├── 📄 config.py            # 配置管理
│       └── 📄 helpers.py           # 輔助函數
│
├── 📁 scripts/                     # 🎛️ 自動化套件
│   ├── 📄 README.md                # 腳本文檔
│   ├── 📄 control_center.py        # 🎛️ 主控制腳本
│   ├── 📄 daily_report.py          # 📊 每日進度報告
│   ├── 📄 translation_monitor.py   # 🚨 質量監控
│   ├── 📄 workflow_optimizer.py    # 📈 工作流優化
│   ├── 📄 project_sync.py          # 🔄 項目同步
│   ├── 📄 notification_manager.py  # 📧 團隊通知
│   ├── 📄 translation_automator.py # 🤖 AI 自動化
│   ├── 📄 mass_exporter.py         # 📦 多格式導出
│   ├── 📄 scheduler.py             # 🕒 任務調度
│   └── 📄 demo_workflow.py         # 🎯 完整演示
│
├── 📁 examples/                    # 使用示例
│   ├── 📄 basic_usage.py          # 基本 MCP 使用
│   ├── 📄 automation_examples.py  # 自動化示例
│   └── 📄 integration_guide.md    # 集成指南
│
└── 📁 docs/                       # 文檔
    ├── 📄 INSTALLATION.md         # 詳細安裝說明
    ├── 📄 CONFIGURATION.md        # 配置指南
    ├── 📄 API_REFERENCE.md        # API 文檔
    └── 📄 CONTRIBUTING.md         # 貢獻指南

🔧 配置

環境變量

在根目錄下創建一個 .env 文件：

# POEditor API 配置
POEDITOR_API_TOKEN=your_api_token_here
POEDITOR_API_URL=https://api.poeditor.com/v2/

# MCP 服務器配置
MCP_SERVER_NAME=poeditor-mcp
MCP_SERVER_VERSION=1.0.0

# 通知設置（可選）
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your_email@company.com
SMTP_PASSWORD=your_app_password

SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...

# 自動化設置
DEFAULT_EXPORT_FORMAT=json
MAX_RETRIES=3
REQUEST_TIMEOUT=30
LOG_LEVEL=INFO

調度器配置

在 scripts/scheduler_config.json 中自定義自動化調度：

{
  "schedules": {
    "daily_report": {
      "time": "08:00",
      "enabled": true,
      "weekdays_only": true,
      "description": "生成每日進度報告"
    },
    "monitoring": {
      "time": "09:00",
      "enabled": true,
      "weekdays_only": true,
      "description": "運行翻譯質量監控"
    },
    "weekly_optimization": {
      "day": "monday",
      "time": "08:30",
      "enabled": true,
      "description": "每週工作流優化分析"
    }
  }
}

🔄 自動化工作流

每日自動化

• 🌅 早上：質量監控和進度報告。
• 🕙 中午：基於 AI 的翻譯建議。
• 🌆 晚上：為開發團隊導出更新。

每週優化

• 📊 週一：工作流分析和優化建議。
• 🔄 週三：項目同步和一致性檢查。
• 📦 週五：完整備份和多格式導出。

即時監控

• 🚨 質量警報：模糊翻譯、一致性問題。
• 📈 進度跟蹤：語言完成里程碑。
• 👥 團隊通知：通過 Slack/電子郵件更新重要事件。

🎯 支持的導出格式

適用於任何開發工作流：

• 📱 移動：Android XML、iOS Strings、React Native JSON。
• 🌐 Web：JSON、CSV，適用於 React/Vue/Angular 應用程序。
• 🖥️ 後端：Gettext PO、Java Properties、YAML。
• 📊 分析：Excel XLSX、CSV，用於進度跟蹤。
• 🔄 集成：XLIFF、TMX，用於 CAT 工具。

🆘 故障排除

常見問題

連接失敗

# 測試你的 POEditor API 令牌
python test_connection.py

# 檢查配置
python control_center.py status

缺少依賴項

# 重新安裝依賴項
pip install -r requirements.txt

# 運行系統診斷
python control_center.py test

權限錯誤

# 修復文件權限
chmod +x setup.py
chmod +x control_center.py

獲取幫助

1. 🔍 檢查日誌：./logs/ 目錄包含詳細的執行日誌。
2. 🧪 運行診斷：python control_center.py test。
3. 📊 系統狀態：python control_center.py status。
4. 🐛 報告問題：創建一個 GitHub 問題，並附上日誌詳細信息。

🤝 貢獻

我們歡迎貢獻！請參閱 貢獻指南 瞭解以下詳細信息：

• 🐛 報告錯誤。
• 💡 建議功能。
• 🔧 提交拉取請求。
• 📖 改進文檔。

📄 許可證

本項目根據 MIT 許可證授權 - 有關詳細信息，請參閱 LICENSE 文件。

🌟 致謝

• Model Context Protocol 提供了出色的 MCP 框架。
• POEditor 提供了全面的翻譯管理 API。
• 開源社區提供了靈感和最佳實踐。

⭐ 如果這個項目對你有幫助，請考慮給它點個星！

🚀 立即開始自動化你的翻譯工作流！