Juhe Mobile Phone Location MCP Server

What is Juhe Mobile Phone Location MCP Server?

The Juhe Mobile Phone Location MCP Server is a Model Context Protocol server that lets large language models query the geographic location and carrier information (province, city, operator) of a Chinese mobile phone number. It serves as a bridge between LLMs and the Juhe location API, making phone number location data accessible to AI applications.

How to use Juhe Mobile Phone Location MCP Server?

Install the server with uvx jmobile-location-mcp-server or via pip install jmobile-location-mcp-server. Set the environment variable JUHE_MOBILE_LOCATION_API_KEY to your Juhe API key, then configure the server in your MCP client (e.g., Claude Desktop's claude_desktop_config.json). Once running, call the get_mobile_phone_location tool with a phone string parameter to retrieve location data.

Key features of Juhe Mobile Phone Location MCP Server

• Provides mobile phone number location lookup via Juhe API
• Returns province, city, and carrier information
• Exposes a single simple tool: get_mobile_phone_location
• Designed for integration with LLMs through MCP
• Requires only an API key for configuration
• Works with Claude Desktop and MCP-compatible clients

Use cases of Juhe Mobile Phone Location MCP Server

• Automatically identifying the province and city of a phone number during a conversation
• Determining the mobile carrier (e.g., China Mobile, China Unicom) of a phone number
• Validating or enriching user-provided phone number data in LLM workflows
• Supporting customer service or logistics applications that need phone location context

FAQ from Juhe Mobile Phone Location MCP Server

What information does the server return for a phone number?

It returns the province, city, and mobile carrier (operator) associated with the phone number’s prefix.

What are the installation and runtime requirements?

Python 3.10 or higher is required. You can install via uvx (recommended) or pip install jmobile-location-mcp-server.

How do I get the API key needed to run the server?

You need a JUHE API key for the mobile location API, obtainable at https://www.juhe.cn/docs/api/id/11. Set it as the environment variable JUHE_MOBILE_LOCATION_API_KEY.

How do I configure the server with Claude Desktop?

Edit the claude_desktop_config.json file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%/Claude/claude_desktop_config.json) and add an entry for jmobile-location-mcp-server with the command, arguments, and environment variable as shown in the README examples.