Name Origin Server

名称来源预测器

基于Python的MCP（模型上下文协议）服务器，使用Nationalize.io API预测名称的来源。

特性

• 预测单个名称的来源
• 多个名称的批量预测
• 实时API与Nationalize.io的集成
• MCP协议支持无缝集成

先决条件

• Python 3.x
• 虚拟环境（推荐）
• 所需软件包：

- httpx - mcp服务器

安装

1. 克隆存储库：

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

1. 创建并激活虚拟环境：

python3 -m venv venv
source venv/bin/activate  # On Unix/macOS
# or
.\venv\Scripts\activate  # On Windows

1. 安装依赖项：

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对象

1. batch_predict(names: list[str])：预测多个名称的来源

- 输入：姓名列表 - 输出：JSON对象，每个名称都有预测

示例响应

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

api参考

该项目使用 国家化.io API 预测名字的来源。API基本使用是免费的，但有费率限制。

错误处理

服务器处理各种错误情况：

• 名称格式无效
• API连接问题
• 速率限制
• 服务器错误

发展

为该项目做出贡献：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

致谢

• 民族化.io 用于提供名称来源预测API
• 服务器实现框架的MCP协议