Poeditor MCP

🚀 🌐 POEditor MCP Server

POEditorの翻訳管理に特化した包括的なモデルコンテキストプロトコル（MCP）サーバーです。高度な自動化スクリプトとワークフロー最適化ツールを備えています。

🚀 クイックスタート

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

# .envファイルを編集して、POEditor APIトークンを設定する
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自動化：インテリジェントな翻訳提案と一貫性チェックを行います。
• 📧 通知機能：チームへの更新情報をEmailとSlackで通知します。
• 📦 大量エクスポート：すべてのプラットフォームに対応した多形式のエクスポートシステムがあります。
• 🕒 スケジューラー：cronのような機能で自動タスクを実行します。

🎯 このMCPサーバーの魅力

他のMCPサーバーが複雑なDockerセットアップを必要とするのに対し、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ドキュメント
• 🚀 統合ガイド - プラットフォーム統合の例
• 🤝 コントリビューションガイド - プロジェクトへの貢献方法

🆘 トラブルシューティング

一般的な問題

接続エラー

# 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のIssueを作成してください。

🤝 コントリビュートについて

コントリビューションを歓迎します！詳細についてはコントリビューションガイドを参照してください。

• 🐛 バグの報告
• 💡 機能の提案
• 🔧 プルリクエストの提出
• 📖 ドキュメントの改善

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

🌟 謝辞

• Model Context Protocol 素晴らしいMCPフレームワークを提供してくれました。
• POEditor 包括的な翻訳管理APIを提供してくれました。
• オープンソースコミュニティ インスピレーションとベストプラクティスを提供してくれました。

⭐ このプロジェクトが役に立ったら、スターをつけてください！

🚀 今日から翻訳ワークフローを自動化しましょう！