Intento Translation MCP Server

Intento Translation MCP Server

これは、Intento API を使用して翻訳機能を提供する MCP サーバーです。

セットアップ

1. 必要な依存関係をインストールします。

pip install -r requirements.txt

2. Intento API の認証情報を設定します。

方法は 2 つあります。

2.a. MCP サーバーの Intento API 認証情報を設定する（すべての MCP クライアントで同じ認証情報を使用します）

MCP サーバーの Intento API 認証情報を設定するには、次の手順を実行します。

• プロジェクトのルートに .env ファイルを作成します。
• Intento API キーを追加します。

INTENTO_API_KEY=your_api_key_here

2.b. 特定の MCP 統合（例：Claude Desktop）の Intento API 認証情報を設定する（MCP クライアントごとに異なる認証情報を使用できます）

特定の MCP 統合の Intento API 認証情報を設定するには、次の手順を実行します。

• MCP 設定 JSON ファイルの「env」セクションを使用して、「INTENTO_API_KEY」変数を指定します。例として、Claude Desktop Integration のセクションを参照してください。

使用方法

1. サーバーを起動します。

python server.py

2. サーバーは、以下のツールとリソースを提供します。

translate

言語間でテキストを翻訳します。言語名と ISO コードの両方を受け付けます。

パラメーター：

• text（必須）：翻訳するテキスト
• target_language（必須）：翻訳先の言語（例：「Spanish」または「es」）
• source_language（任意）：翻訳元の言語（デフォルトは自動検出を行う空文字列）

例：

# Translate with automatic language detection
result = await translate("Hello world", target_language="Spanish")

# Translate with specific source language
result = await translate("Hello world", target_language="Spanish", source_language="English")

language-codes（リソース）

リソース URL：mcp://intento-translate/language-codes

Intento API がサポートする、言語名と ISO コードの対応関係を提供します。

このリソースを使用すると、エージェントは次のことができます。

• 利用可能な言語を確認する
• 言語名に対応する正しい ISO コードを検索する
• Intento API との互換性を確保する

リソースの使用例：

# Get the language codes resource
language_codes = await get_resource("mcp://intento-translate/language-codes")

# Look up a language code
spanish_code = language_codes["codes"]["spanish"]  # Returns "es"

# Use the code in a translation
result = await translate("Hello world", target_language=spanish_code)

言語サポート

サーバーは Intento API から言語コードを動的に取得し、リソースとして利用できるようにします。この方法には、次のような利点があります。

1. 動的な更新：言語サポートは常に Intento API の最新情報に更新されます。
2. エージェントの自律性：エージェントは適切な言語コードを自ら確認し、使用できます。
3. 柔軟性：サーバーは言語名と ISO コードの両方に対応できます。

言語の自動検出

source_language パラメーターが空の場合（デフォルト）、サーバーは次の処理を行います。

• API リクエストから翻訳元の言語フィールドを省略する
• Intento に翻訳元の言語を自動検出させる
• リクエストが「auto-detect」を使用していることを明確にするため、ログに記録する

API リクエストに失敗した場合、サーバーは一般的な言語コードの最小セットにフォールバックします。

エラー処理

サーバーには、包括的なエラー処理とログ記録が含まれています。

• すべての操作は logs/intento-translate.log に記録されます。
• API エラーは捕捉され、内容が分かるメッセージとともに返されます。
• 無効な言語コードは適切に処理されます。

Claude Desktop との統合

この MCP サーバーを Claude Desktop で使用するには、次の手順を実行します。

1. Claude Desktop の設定ディレクトリに claude-mcp-config.json ファイルを作成します。

   • Windows：%APPDATA%\Claude\claude-mcp-config.json
   • macOS：~/Library/Application Support/Claude/claude-mcp-config.json
   • Linux：~/.config/Claude/claude-mcp-config.json

2. 次の設定を追加します（インストール環境に合わせてパスを調整してください）。

{
    "mcpServers": {
        "intento-translate": {
            "command": "python",
            "args": ["/path/to/your/mcp-intento-translate/server.py"],
            "cwd": "/path/to/your/mcp-intento-translate",
            "env": {
                "INTENTO_API_KEY": "<YOUR_API_KEY>" 
            }
        }
    }
}

「INTENTO_API_KEY」を含む「env」部分が必要なのは、MCP サーバー固有の認証情報ではなく、この統合で個別の認証情報を使用する場合のみです。

3. Claude Desktop を再起動して、新しい設定を読み込みます。

これでサーバーが Claude Desktop から利用可能になり、MCP プロトコルを通じて翻訳機能と言語コード情報を提供します。