Name Origin Predictor

🚀 名字起源預測服務器

名字起源預測服務器是一個基於 MCP（模型上下文協議）的 Python 服務器，藉助 Nationalize.io API 實現對名字起源的預測。它能滿足單個或批量名字的起源預測需求，還支持 MCP 協議，便於無縫集成。

🚀 快速開始

名字起源預測服務器可通過 Nationalize.io API 預測名字起源，支持單個或批量預測，還能與 MCP 協議無縫集成。

✨ 主要特性

• 🔍 可預測單個名字的起源。
• 📦 支持批量預測多個名字的起源。
• ⚙️ 即時集成 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

🛠️ 配置

創建 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 協議用於服務器實現框架