Skip to main content

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

Project description

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
Using uvx
"mcpServers": {
  "jmobile-location-mcp-server": {
    "command": "uvx",
    "args": [
      "jmobile-location-mcp-server"
    ],
    "env": {
      "JUHE_MOBILE_LOCATION_API_KEY": "your_api_key"
    }
  }
}
Using pip installation
"mcpServers": {
  "jmobile-location-mcp-server": {
    "command": "python",
    "args": [
      "-m",
      "jmobile_location_mcp_server"
    ],
    "env": {
      "JUHE_MOBILE_LOCATION_API_KEY": "your_api_key"
    }
  }
}

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"

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jmobile_location_mcp_server-0.1.1.tar.gz (16.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jmobile_location_mcp_server-0.1.1-py3-none-any.whl (4.6 kB view details)

Uploaded Python 3

File details

Details for the file jmobile_location_mcp_server-0.1.1.tar.gz.

File metadata

File hashes

Hashes for jmobile_location_mcp_server-0.1.1.tar.gz
Algorithm Hash digest
SHA256 2ad373c6d905f52a4e3a5367afbbbe47e25c3ff66340ada518b8a5d7d95741f4
MD5 4bc2d32621d3827b2f06a1dcb6237371
BLAKE2b-256 6ece845b55b2609c3c77675919907214499e9d0f235644312f600034383bc366

See more details on using hashes here.

Provenance

The following attestation bundles were made for jmobile_location_mcp_server-0.1.1.tar.gz:

Publisher: publish-pypi.yml on juhemcp/jmobile-location-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file jmobile_location_mcp_server-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for jmobile_location_mcp_server-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3a3fbb51c586473b0295a6ef3064a2fc8d736e2e1662ca867672acb8a5a0d327
MD5 8017759e77a0dc64eb98e1dd5ab5545d
BLAKE2b-256 493bad3bc2044e6d1ed65de27f7c675c59bec94439db8547297bd21c673afac7

See more details on using hashes here.

Provenance

The following attestation bundles were made for jmobile_location_mcp_server-0.1.1-py3-none-any.whl:

Publisher: publish-pypi.yml on juhemcp/jmobile-location-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page