Juhe Mobile Location

Provides mobile number location data by querying Juhe’s API to return province, city, and carrier information.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "juhemcp-jmobile-location-mcp-server": {
      "command": "uvx",
      "args": [
        "jmobile-location-mcp-server"
      ],
      "env": {
        "JUHE_MOBILE_LOCATION_API_KEY": "your_api_key"
      }
    }
  }
}

This MCP server lets a large language model query the ownership details of a mobile phone number, returning province, city, and carrier information. It connects to Juhe’s mobile location data to provide fast, precise location context that enhances number-based conversations and routing decisions.

How to use

You can run the server locally and connect to it with an MCP client. The server exposes a tool named get_mobile_location that accepts a phone number string parameter and returns the corresponding location information. Once the server is running, you can ask it to look up the ownership details for any mobile number to gain contextual insights for routing, personalization, or validation.

How to install

Prerequisites: Python 3.10 or higher. A runtime command to start the server is needed for the local MCP setup.

Install using uvx (recommended) and run the server with the following command.

uvx jmobile-location-mcp-server

Alternatively you can install via Python's package index and run the module as a script.

pip install jmobile-location-mcp-server

python -m jmobile_location_mcp_server

Configuration

Environment variable for API access: JUHE_MOBILE_LOCATION_API_KEY. This key authenticates requests to Juhe’s mobile location API and enables the server to fetch number ownership data.

JUHE_MOBILE_LOCATION_API_KEY=your_api_key

Additional setup for MCP clients

If you use the uvx approach, configure the MCP server entry with the following settings to ensure the API key is supplied to the runtime.

"mcpServers": {
  "jmobile-location-mcp-server": {
    "command": "uvx",
    "args": [
      "jmobile-location-mcp-server"
    ],
    "env": {
      "JUHE_MOBILE_LOCATION_API_KEY": "your_api_key"
    }
  }
}

Tools and endpoints

Available tool: get_mobile_location which accepts a required phone parameter and returns location data as text or related media content.

Debugging and inspection

You can verify and debug the MCP server with the MCP inspector. For uvx-based runs, use the following command to attach the inspector.

npx @modelcontextprotocol/inspector uvx jmobile-location-mcp-server

Examples of questions for the model

Example query: “查询下这个手机号码的归属地信息 18912341234”

Available tools

get_mobile_location

Query the server with a phone number to obtain its location details, including province, city, and carrier information.