Name Origin Predictor

🚀 名前起源予測サーバー

このサーバーは、MCP（モデルコンテキストプロトコル）に基づくPythonサーバーで、Nationalize.io APIを通じて名前の起源を予測します。

🚀 クイックスタート

名前起源予測サーバーは、Pythonで実装されたMCPベースのサーバーで、Nationalize.io APIを利用して名前の起源を予測します。以下の手順に従って、サーバーをセットアップして利用することができます。

✨ 主な機能

• 単一の名前の起源を予測する
• 複数の名前の起源を一括で予測する
• Nationalize.io APIをリアルタイムで統合する
• MCPプロトコルをサポートし、シームレスな統合を実現する

📦 インストール

前提条件

• Python 3.x
• 仮想環境（推奨）
• 必要なライブラリ：
  • httpx
  • mcp-server

インストール手順

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

git clone https://github.com/allglenn/mcp-name-origin-server.git
cd mcp-name-origin-server

2. 仮想環境を作成してアクティブ化します：

python3 -m venv venv
source venv/bin/activate  # Unix/macOSシステムでのコマンド
# または
.\venv\Scripts\activate  # Windowsシステムでのコマンド

3. 依存関係をインストールします：

pip install httpx

📚 ドキュメント

設定

1. claude_desktop_config.json ファイルを作成します：

{
    "mcpServers": {
        "origin": {
            "command": "source",
            "args": [
                "venv/bin/activate",
                "&&",
                "python3",
                "-u",
                "mcp-server.py"
            ],
            "shell": true,
            "env": {
                "PYTHONPATH": ".",
                "PYTHONUNBUFFERED": "1"
            }
        }
    },
    "defaultServer": "origin",
    "version": "0.1.0"
}

使用方法

サーバーの起動

python mcp-server.py

利用可能なメソッド

1. predict_origin(name: str)：単一の名前の起源を予測します。

   • 入力：名前を含む文字列
   • 出力：国の予測と確率を含むJSONオブジェクト

2. batch_predict(names: list[str])：複数の名前の起源を一括で予測します。

   • 入力：名前のリスト
   • 出力：各名前の予測結果のJSONオブジェクト

応答例

{
    "name": "glenn",
    "country": [
        {
            "country_id": "US",
            "probability": 0.421
        },
        {
            "country_id": "AU",
            "probability": 0.044
        }
    ]
}

APIリファレンス

このプロジェクトは、名前の起源を予測するためにNationalize.io APIを使用しています。このAPIは基本的な使用については無料で提供されていますが、レート制限があります。

エラー処理

サーバーは以下のような様々なエラー状況を処理します：

• 無効な名前の形式
• API接続問題
• レート制限
• サーバーエラー

開発

このプロジェクトに貢献するには、以下の手順に従ってください：

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. プルリクエストを送信します。

📄 ライセンス

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

謝辞

• Nationalize.io は名前の起源予測APIを提供してくれました。
• MCPプロトコルはサーバーの実装フレームワークとして利用されています。