PolarHub
  • Agents
  • MCP Servers
  • Skills
  • PolarBear
PolarHub © 2026
MCP Serverslocation-servicesMCP天气地图工具
返回「location-services」

MCP天气地图工具

modelscope·@chenchen0611/mcp-python-demo

location-services0下载LocalModelScope

简介

一个基于MCP的项目,集成智谱AI和腾讯地图API,通过命令行和网页界面提供天气查询、地理编码和网页搜索功能。

MCP Server 详情

来自 ModelScope 索引

MCP Python Demo

这是一个基于 MCP (Model Context Protocol) 的项目,集成了智谱 AI 和腾讯地图 API,提供了天气查询、地理编码和网络搜索等功能。项目包含命令行界面和 Web 界面两种交互方式。

功能特性

  • 🤖 智谱 AI 驱动的对话系统
  • 🌤️ 腾讯地图天气查询
  • 🗺️ 地理编码查询
  • 🔍 智能网络搜索
  • 💻 命令行和 Web 界面双重支持
  • 🌐 支持外网访问

项目结构

mcp-python-demo/
├── src/
│   └── mcp_python_demo/
│       ├── __init__.py
│       ├── server.py
│       ├── client.py
│       ├── web_client.py
│       └── main.py
├── images/
├── pyproject.toml
├── .env
├── .env.example
├── .gitignore
└── README.md

快速开始

环境要求

  • Python >= 3.10
  • uv (推荐) 或 pip

安装

  1. 克隆项目:
git clone https://github.com/chenchen0611/mcp-python-demo.git
cd mcp-python-demo
  1. 使用 uv 安装依赖:
uv venv
source .venv/bin/activate  # Linux/Mac
# 或
.venv\Scripts\activate  # Windows
uv pip install -e .

配置

  1. 创建 .env 文件并配置必要的环境变量:
# 智谱AI配置
ZHIPU_API_KEY="your-zhipu-api-key"
ZHIPU_MODEL="glm-4-plus"
ZHIPU_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"

# 腾讯地图API配置
TENCENT_MAP_API_KEY="your-tencent-map-api-key"
TENCENT_MAP_API_BASE="https://apis.map.qq.com/ws/"

运行

Web 界面(推荐)

cd src/mcp_python_demo
streamlit run web_client.py

访问以下地址之一:

  • 本地访问:http://localhost:8501
  • 局域网访问:http://[your-local-ip]:8501
  • 外网访问:http://[your-public-ip]:8501
页面配置
  • 直接输入server.py,点击连接 config
  • 新建一个terminal,运行下方命令然后在web页面输入http://127.0.0.1:8000
    cd src/mcp_python_demo
    uv run server.py
    
    config

命令行界面

cd src/mcp_python_demo
# 使用本地服务器
uv run client.py --agent server.py

# 或使用远程服务器
uv run server.py
uv run client.py --agent http://127.0.0.1:8000

config

可用工具

1. 天气查询

async def query_weather(adcode: str, search_type: str = "now") -> str:
    """获取中国城市天气信息"""

2. 地理编码查询

async def query_adcode(region_name: str) -> str:
    """获取行政区划代码"""

3. 网络搜索

async def web_search(search_query: str, search_engine: str = "search_std") -> str:
    """使用智谱AI进行网络搜索"""

开发说明

添加新工具

  1. 在 server.py 中使用 @mcp.tool() 装饰器添加新工具:
@mcp.tool()
async def your_tool(param1: str, param2: str = "default") -> str:
    """工具描述"""
    # 实现逻辑
    return result
  1. 工具会自动在客户端可用

环境变量

  • 所有敏感信息和配置都应该放在 .env 文件中
  • 不要将 .env 文件提交到版本控制系统
  • 参考 .env.example 进行配置

常见问题

  1. 连接错误

    • 检查服务器地址是否正确
    • 确认所有环境变量都已正确配置
    • 确保服务器正在运行且端口可访问
  2. API 调用失败

    • 验证 API 密钥是否有效
    • 检查网络连接
    • 确认 API 调用频率是否超限
  3. Web UI 无法访问

    • 检查防火墙设置
    • 确认端口是否开放
    • 验证服务器 IP 地址是否正确

致谢

本项目基于以下开源项目:

  • Model Context Protocol Servers - MCP 官方服务器参考实现,提供了丰富的示例和最佳实践
  • MCP Python SDK - Python SDK 实现,提供了简洁优雅的 API 接口

相关 MCP Servers(来自「location-services」)

酒店查询预订管家

暂无描述。

liu860502/Hotel_MCP

快递100 MCP Server

快递100 MCP Server提供快递信息查询、快递运费预估比价、快递时效查询(含发货前时效查询与在途动态时效查询)等功能。

kuaidi100/kuaidi100-mcp

全球酒店推荐预订-RollingGo

全球酒店预订 MCP 服务,全球第三大B2B酒旅供应商官方出品,提供 200 万 + 酒店搜索、价格查询、可订检查和订单创建能力,让 AI 一键拥有原生酒店预订功能,企业和个人均可一键接入,完全免费。 支持通过城市名称、机场代码、热门景点、交通枢纽、酒店名称或具体地址等多种目标地点类型进行精准搜索,并提供灵活的星级筛选、入住日期设置、住宿天数配置等专业筛选功能。 还可基于用户的个人偏好或特定条件(如距离景点/机场/市中心更近)提供个性化酒店推荐,并生成多维度热门榜单,包括高性价比酒店、好评热门酒店、人气精选等不同类型的专业推荐。 整个工具能够通过自然语言交互,智能完成从地点解析、酒店筛选、个性化推荐到预订支付的完整服务流程,为各类商务出行、家庭度假和个人旅行提供精准、高效的酒店选择解决方案。

yorklu/AI_Go_Hotel_MCP

DataV-Atlas地理可视化

DataV Atlas MCP服务是阿里云DataV团队提供的地理空间数据可视化MCP服务,提供地理空间数据的大模型可视分析能力,包含地理空间数据处理、地理空间数据生成、地理空间可视化布局算法、地理空间可视化编码工具等。

@DataV-Atlas/atlas-tools-mcp-server

ip地址归属地查询

可获取本地公网ip,并且支持任意ip地址归属地查询

nmgliangwei/ip2region

UU跑腿MCP

现已支持5个核心API接口和MCP协议的对接, 涵盖询价、发单、查询详情等,是国内首家兼容MCP协议的配送服务商。

@uupt-mcp/uupt-mcp-server

自动安装

点击按钮会唤起 PolarBear 客户端,并把当前 MCP Server 的 Markdown 详情文档地址传给客户端。

/api/mcps/chenchen0611-mcp-python-demo/markdown
打开 PolarBear 安装查看 Markdown 文档

手动安装

在 PolarBear 或其他支持 MCP 的客户端中,新建 MCP Server,并参考下方来源或安装提示配置。

mcp-python-demo/ ├── src/ │ └── mcp_python_demo/ │ ├── __init__.py │ ├── server.py │ ├── client.py │ ├── web_client.py │ └── main.py ├── images/ ├── pyproject.toml ├── .env ├── .env.example ├── .gitignore └── README.md

基本信息

分类
location-services / search
运行方式
No
许可证
Unknown
详情文件
chenchen0611-mcp-python-demo.md