Poeditor MCP

🚀 POEditor MCP Server

POEditorの翻訳管理APIとやり取りするためのモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このサーバーを使用することで、POEditorの翻訳管理APIと連携することができます。

📦 インストール

以下のコマンドを実行して、必要なパッケージをインストールし、ビルドします。

npm install
npm run build

📚 ドキュメント

設定

クライアント（例：Claude Desktop）でMCPサーバーを設定するには、MCP設定に以下の内容を追加します。

{
  "mcpServers": {
    "poeditor": {
      "command": "npx",
      "args": ["tsx", "/path/to/poeditor-mcp/src/server.js"],
      "env": {
        "POEDITOR_API_TOKEN": "your_api_token_here",
        "POEDITOR_PROJECT_ID": "your_project_id"
      }
    }
  }
}

⚠️ 重要提示

• POEDITOR_API_TOKENは必須です。POEditor API Accessから取得できます。
• POEDITOR_PROJECT_IDは任意です。デフォルトのプロジェクトIDを指定できますが、ツール呼び出しごとに上書き可能です。

利用可能なツール

• add_terms_with_translations ⭐ 推奨 - 一度の操作で複数の新しい用語を作成し、その翻訳を追加します。
• add_translations - 既存の用語に翻訳を追加します（上書きしません）。
• update_translations - 既存の翻訳を更新/上書きします。
• list_terms - すべての用語をリストします（オプションで翻訳も含む）。
• list_languages - プロジェクトで現在有効になっている言語をリストします。
• list_available_languages - POEditorがサポートするすべての言語をリストします（言語を追加する際の参考に）。
• add_language - プロジェクトに新しい言語を追加します。

⚠️ 重要提示

POEditorはterm + contextの組み合わせを一意の識別子として使用します。用語がコンテキスト値付きで作成された場合、その用語の翻訳を追加または更新するときに同じコンテキストを提供する必要があります。 そうしないと、POEditorは翻訳を正しい用語にマッチさせることができません。

📄 ライセンス

MIT