🚀 名字起源预测服务器

名字起源预测服务器是一个基于 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 协议用于服务器实现框架