Juhe Mobile Phone Location MCP Server

by juhemcp

344 downloads
Not rated
GitHub

Description

# Juhe Mobile Phone Location MCP Server 一个提供手机号码(段)所属归属地查询功能的模型上下文协议(Model Context Protocol)服务器。该服务器使大型语言模型(LLMs)能够获取手机号码段归属地信息,如:省份、城市、运营商。 ## Components ### Tools 服务器实现了一个工具: - get_mobile_phone_location: 根据手机号码查询其所属地信息。 - 需要传入 "phone"(手机号码)作为必须的字符串参数。 ``` async def…

About

# Juhe Mobile Phone Location MCP Server 一个提供手机号码(段)所属归属地查询功能的模型上下文协议(Model Context Protocol)服务器。该服务器使大型语言模型(LLMs)能够获取手机号码段归属地信息,如:省份、城市、运营商。 ## Components ### Tools 服务器实现了一个工具: - get_mobile_phone_location: 根据手机号码查询其所属地信息。 - 需要传入 "phone"(手机号码)作为必须的字符串参数。 ``` async def get_mobile_location(phone: str = "") ->…

Details

Author
juhemcp
Downloads
344
Categories
Media

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Juhe Mobile Phone Location MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "juhe mobile phone location mcp server": {
            "jmobile-location-mcp-server": {
                "command": "uvx",
                "args": [
                    "jmobile-location-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "jmobile-location-mcp-server": {
        "command": "uvx",
        "args": [
            "jmobile-location-mcp-server"
        ]
    }
}

Juhe Mobile Phone Location MCP Server

一个提供手机号码(段)所属归属地查询功能的模型上下文协议(Model Context Protocol)服务器。该服务器使大型语言模型(LLMs)能够获取手机号码段归属地信息,如:省份、城市、运营商。

Components

Tools

服务器实现了一个工具:

- get_mobile_phone_location: 根据手机号码查询其所属地信息。
- 需要传入 "phone"(手机号码)作为必须的字符串参数。

async def get_mobile_location(phone: str = "") -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:

Install

This server requires Python 3.10 or higher. Install dependencies using uv (recommended) or pip

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run jmobile-location-mcp-server.
uvx jmobile-location-mcp-server

Using PIP

Alternatively you can install jmobile-location-mcp-server via pip:
pip install jmobile-location-mcp-server
After installation, you can run it as a script using:
python -m jmobile_location_mcp_server

Configuration

Environment Variables

JUHE_MOBILE_LOCATION_API_KEY: 聚合数据的手机归属地查询API密钥。获取:https://www.juhe.cn/docs/api/id/11
JUHE_MOBILE_LOCATION_API_KEY=your_api_key

Claude Desktop

- On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%/Claude/claude_desktop_config.json

<details>
<summary>Using uvx</summary>

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

<details>
<summary>Using pip installation</summary>

  "mcpServers": {
    "jmobile-location-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "jmobile_location_mcp_server"
      ],
      "env": {
        "JUHE_MOBILE_LOCATION_API_KEY": "your_api_key"
      }
    }
  }
  
</details>

Debugging

You can use the MCP inspector to debug the server. For uvx installations:
npx @modelcontextprotocol/inspector uvx jmobile-location-mcp-server 

Or if you've installed the package in a specific directory or are developing on it:

cd path/to/servers/src/jmobile-location-mcp-server
npx @modelcontextprotocol/inspector uv run jmobile-location-mcp-server

Examples of Questions for Cline

1. "查询下这个手机号码的归属地信息 18912341234"
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.