一、环境搭建

环境搭建参考地址：https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#overview

1.1 安装 uv

uv 是 Python 环境管理工具，也是 MCP 官方推荐的 Python 项目管理工具，详情参考：https://docs.astral.sh/uv/getting-started/features/

安装命令（Windows/macOS/Linux 通用）：

1.2 安装 Python

通过 uv 安装指定版本 Python（推荐 3.13）：

1.3 创建项目并安装 MCP 依赖

执行以下命令，完成项目创建和依赖安装：

验证说明：执行uv run mcp 后，若显示 MCP 的 CLI 帮助信息，即为安装成功。

二、Python 完整可运行代码

2.1 创建测试文件

在项目根目录（jikeapi_mpc_client）下，创建 main.py 文件，复制以下完整可运行代码（已修复原代码索引错误）。

2.2 完整代码

三、运行测试

在项目目录（jikeapi_mpc_client）下，执行以下命令运行测试：

3.1 预期返回结果

 即刻 MCP Server 连接并初始化成功

正在查询可用工具列表...

 可用工具列表：

[1] 工具名称: ip_query_v4
   工具描述: 查询 IPv4 地址的归属地、运营商等信息

 调用工具：ip_query_v4（传入参数：ip=61.150.48.126）

 工具返回结果：
本机IP 61.150.48.126
归属地 中国 陕西省 西安市
运营商 电信

四、注意事项

请务必将 JIKEAPI_MCP_URL 替换为你的专属 MCP URL，获取地址：https://mcp.jikeapi.com/mcp

若工具调用失败，需检查：MCP URL 是否正确、工具参数是否匹配（可参考工具的 parameters 信息调整）

Python 版本需为 3.13，否则可能出现依赖兼容问题

若 uv 安装失败，可参考 uv 官方文档排查：https://docs.astral.sh/uv/getting-started/installation/

文档更新时间：2026年3月
技术支持： 即刻MCP Server官方技术团队；

➣ Python接入

一、环境搭建#

1.1 安装 uv#

1.2 安装 Python#

1.3 创建项目并安装 MCP 依赖#

二、Python 完整可运行代码#

2.1 创建测试文件#

2.2 完整代码#

三、运行测试#

3.1 预期返回结果#

四、注意事项#