Devnagri Translation MCP Server

@devnagriai/devnagriai-translate-mcp

Devnagri AI API を介して翻訳、言語検出、対応言語の一覧表示を提供する、インド系言語に重点を置いた JavaScript ベースの Model Context Protocol（MCP）サーバーです。

機能

• テキスト翻訳 35 以上の言語に対応（主要なインド系言語をすべて含む）
• 言語検出 あらゆる入力テキストに対応
• 対応言語の一覧表示
• MCP プロトコル AI ツールとの統合に対応
• 堅牢なエラー処理と検証
• 充実したテストスイート

目次

• 機能
• クイックスタート
• API キーの取得
• インストール
  • NPX（推奨）
  • 手動インストール
• 使い方
  • 直接統合
  • サーバーの実行
• MCP ツール
  • ツール：translate
  • ツール：detect_language
  • ツール：list_supported_languages
• 設定
• テスト
• コントリビューション
• サポート
• セキュリティ
• ライセンス

クイックスタート

npx @devnagriai/devnagriai-translate-mcp API_KEY="your_devnagri_api_key"

API キーの取得

Devnagri Translation API を使用するには、API キーが必要です。次の手順に従ってください。

1. サインアップ

   • Devnagri Dashboard にアクセスして、無料アカウントにサインアップします。

2. API Hub にアクセス

   • ログイン後、サイドバーメニューから API Hub セクションに移動します。

3. Translation API を選択

   • Get API Key をクリックします。
   • Create をクリックします。
   • API キーの名前を入力します。
   • Save をクリックします。

4. API キーをコピー

   • 生成された API キーをコピーします。安全に保管し、公開しないでください。

インストール

NPX（推奨）

この MCP サーバーを最も簡単に使うには、インストールせずに実行できる npx を使用します。

npx @devnagriai/devnagriai-translate-mcp API_KEY="your_devnagri_api_key"

Claude、GPT、Windsurf、Cursor などの AI ツールとの統合に最適です。

手動インストール

サーバーをローカルにインストールする場合は、次の手順に従ってください。

1. リポジトリをクローンします。

git clone https://github.com/DevnagriAI/devnagriai-translate-mcp.git
cd devnagriai-translate-mcp

2. 依存関係をインストールします。

npm install

3. 環境変数を設定します。

ルートディレクトリに .env ファイルを作成し、次の内容を記述します。

DEVNAGRI_API_KEY=your_devnagri_api_key

使い方

直接統合

ローカルまたはプライベートでの使用、あるいは開発のために、MCP 設定にサーバーを追加します。

{
  "mcpServers": {
    "devnagri-translation": {
      "command": "npx",
      "args": [
        "@devnagriai/devnagriai-translate-mcp",
        "API_KEY=\"your_devnagri_api_key\""
      ]
    }
  }
}

サーバーの実行

サーバーを起動します。

npm start

自動再読み込みを有効にして開発する場合：

npm run dev

この MCP サーバーは、あらゆる MCP クライアントで使用できます。たとえば、MCP CLI クライアントを使用する場合：

mcp-client --transport stdio -- node src/index.js

AI ツールとの統合

Windsurf

~/.codeium/windsurf/mcp_config.json で設定します。

{
  "devnagri-translation": {
    "command": "npx",
    "args": [
      "@devnagriai/devnagriai-translate-mcp",
      "API_KEY=\"your_devnagri_api_key\""
    ]
  }
}

Cursor

Cursor の設定で指定します。

{
  "tools": {
    "devnagri-translation": {
      "command": "npx",
      "args": [
        "@devnagriai/devnagriai-translate-mcp",
        "API_KEY=\"your_devnagri_api_key\""
      ],
      "transport": "stdio"
    }
  }
}

Claude

Claude Desktop App で設定します。

1. Settings > Extensions に移動します
2. "Add Custom Extension" をクリックします
3. "Add from local server" を選択します
4. 次の詳細を入力します。
   • Name：Devnagri Translation Service
   • Command：npx @devnagriai/devnagriai-translate-mcp API_KEY="your_devnagri_api_key"
   • Transport：stdio

または、次の設定を使用します。

{
  "devnagri-translation": {
    "command": "npx",
    "args": [
      "@devnagriai/devnagriai-translate-mcp",
      "API_KEY=\"your_devnagri_api_key\""
    ],
    "transport": "stdio"
  }
}

MCP ツール

この MCP サーバーでは、次のツールを利用できます。

ツール名	説明
translate	対応言語間でテキストを翻訳します
detect_language	指定されたテキストの言語を検出します
list_supported_languages	利用可能なすべての言語を一覧表示します

ツール設定の例については、examples/mcp_config_example.json を参照してください。

ツール：translate

ソース言語からターゲット言語にテキストを翻訳します。

パラメーター：

• source_text（string、必須）：翻訳するテキスト
• source_language（string、必須）：ソース言語のコード（例：「en」）
• target_language（string、必須）：ターゲット言語のコード（例：「hi」）
• translation_type（string、任意）：翻訳の種類（「literal」または「base」、デフォルトは「literal」）

戻り値：

{
  "translated_text": "नमस्ते, आप कैसे हैं?",
  "source_language": "en",
  "target_language": "hi",
  "translation_type": "literal"
}

ツール：detect_language

指定されたテキストの言語を検出します。

パラメーター：

• text（string、必須）：言語検出の対象テキスト

戻り値：

{
  "detected_language": "en",
  "confidence_score": 0.98,
  "supported": true
}

ツール：list_supported_languages

翻訳でサポートされているすべての言語の一覧を返します。

パラメーター：

• なし

戻り値：

[
  {
    "name": "English",
    "native_name": "English",
    "code": "en"
  },
  {
    "name": "Hindi",
    "native_name": "हिन्दी",
    "code": "hi"
  },
  // ... more languages
]

設定

• API キー：必須です。環境変数またはコマンドライン引数として渡します：API_KEY="your_devnagri_api_key"
• ポート：デフォルトは8080です（MCP プロトコルのパラメーターで設定できます）
• .env のサポート：ローカル開発用に、API キーを .env ファイルに保存できます。

テスト

次のコマンドでテストスイートを実行します：

npm test

テストカバレッジには、すべての MCP ツールと API クライアントロジックの単体テストおよび統合テストが含まれます。

貢献

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更内容を説明したプルリクエストを送信します

サポート

• API に関する問題は、Devnagri Support にお問い合わせください
• MCP サーバーに関する問題は、このリポジトリで GitHub issue を作成してください

セキュリティ

• API キーを公開しないでください
• Devnagri ダッシュボードから API キーを定期的にローテーションしてください

ライセンス

MIT