Skip to main content
Glama
Sign In

MCP Python Demo

by chenchen0611
GitHub
Python
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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 地址是否正确

致谢

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

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP-based project that integrates Zhipu AI and Tencent Map APIs to provide weather queries, geocoding, and web search functionality through both command-line and web interfaces.

  1. 功能特性
    1. 项目结构
      1. 快速开始
        1. 环境要求
        2. 安装
        3. 配置
        4. 运行
      2. 可用工具
        1. 天气查询
        2. 地理编码查询
        3. 网络搜索
      3. 开发说明
        1. 添加新工具
        2. 环境变量
      4. 常见问题
        1. 致谢

          Related MCP Servers

          • MCP Server Example

            ivanbtrujillo
            A
            security
            F
            license
            A
            quality
            A basic MCP server template that can be integrated with Cursor to enable AI tools like weather information retrieval using Claude-3.7-sonnet model.
            Last updated -
            2
            TypeScript

          • Weather Query MCP

            sunholdshen
            -
            security
            F
            license
            -
            quality
            A simple MCP service that allows users to query weather conditions for cities worldwide through the Cursor AI assistant.
            Last updated -
            JavaScript

          • Weather Query MCP Server

            eternachen
            -
            security
            F
            license
            -
            quality
            An MCP server implementation that allows users to fetch and display weather information for specified cities, including temperature, humidity, wind speed, and weather descriptions.
            Last updated -
            Python
            • Linux
            • Apple

          • Customized MCP Server

            MorvanZhou
            -
            security
            A
            license
            -
            quality
            A server that integrates the MCP library with OpenAI's API, allowing users to interact with various tools, such as the weather tool, through natural language queries.
            Last updated -
            Python
            MIT License

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/chenchen0611/mcp-python-demo'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server