使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型（LLMs）提供查询手机号码归属地信息的功能。通过集成此服务器，LLMs 可以利用 'get_mobile_location' 工具，根据用户提供的手机号码查询其归属地信息，包括省份、城市、运营商等。

主要功能点

提供手机归属地查询工具: 实现 'get_mobile_location' 工具，允许 LLM 客户端调用以查询手机号码的归属地信息。
基于 MCP 协议: 遵循 MCP 协议标准，易于与支持 MCP 协议的 LLM 客户端集成。
使用聚合数据API: 使用聚合数据提供的手机归属地查询 API，确保数据准确性和实时性（需要API密钥）。

安装步骤

本服务器使用 Python 编写，需要 Python 3.10 或更高版本。推荐使用 'uv' 或 'pip' 进行安装。

方法一：使用 uv (推荐)

无需特定安装步骤，使用 'uvx' 直接运行：

uvx jmobile-location-mcp-server

方法二：使用 pip

使用 pip 安装：

pip install jmobile-location-mcp-server

安装完成后，可以使用以下命令作为脚本运行：

python -m jmobile_location_mcp_server

服务器配置

本服务器需要配置聚合数据手机归属地查询API密钥。

环境变量配置

需要设置名为 'JUHE_MOBILE_LOCATION_API_KEY' 的环境变量，值为您在聚合数据申请的API密钥。

JUHE_MOBILE_LOCATION_API_KEY=您的API密钥

MCP 客户端配置

您需要在 MCP 客户端（例如 Claude Desktop）的配置文件中添加本服务器的配置信息。以下是两种安装方式对应的配置示例，请根据您的安装方式选择其一添加到 MCP 客户端的配置文件中。

使用 uvx 方式的配置 (例如 Claude Desktop 配置)

"mcpServers": {
  "jmobile-location-mcp-server": {  // 服务器名称，客户端用此名称识别和调用
    "command": "uvx", // 启动命令，使用 uvx 运行
    "args": [
      "jmobile-location-mcp-server" // 启动参数，uvx 直接运行服务器包名
    ],
    "env": {
      "JUHE_MOBILE_LOCATION_API_KEY": "您的API密钥" // 环境变量配置，在此处配置API密钥
    }
  }
}

使用 pip 安装方式的配置 (例如 Claude Desktop 配置)

"mcpServers": {
  "jmobile-location-mcp-server": {  // 服务器名称，客户端用此名称识别和调用
    "command": "python", // 启动命令，使用 python 运行
    "args": [
      "-m", // 参数，以模块方式运行 python 包
      "jmobile_location_mcp_server" // 启动参数，运行 jmobile_location_mcp_server 模块
    ],
    "env": {
      "JUHE_MOBILE_LOCATION_API_KEY": "您的API密钥" // 环境变量配置，在此处配置API密钥
    }
  }
}

注意:

请将 '"您的API密钥"' 替换为您在聚合数据申请的 手机归属地查询API 密钥。
MCP 客户端配置文件路径 (以 Claude Desktop 为例)
- MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您可以向 LLM 提问，例如：

查询下这个手机号码的归属地信息 18912341234

LLM 客户端会自动调用 'get_mobile_location' 工具，并将手机号码 '18912341234' 作为参数传递给 MCP 服务器进行查询，最终返回归属地信息。

关键词