MCP Python Demo

🚀 MCP Python 示例项目

这是一个基于 MCP（模型上下文协议）的项目，集成了智谱 AI 和腾讯地图 API。它提供了天气查询、地理编码和网络搜索等实用功能，并且支持命令行界面和 Web 界面两种交互方式，方便用户在不同场景下使用。

🚀 快速开始

环境要求

• Python >= 3.10
• uv（推荐）或 pip

安装步骤

# 示例安装命令，具体请参考实际文档
pip install mcp-sdk

配置说明

项目需要一些配置文件和环境变量的设置，请参考相关文档完成配置。

运行方式

# 示例运行命令，具体请参考实际文档
python server.py

✨ 主要特性

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

📦 安装指南

环境要求

• Python 版本需大于等于 3.10。
• 推荐使用 uv，也可以使用 pip。

安装命令

pip install mcp-sdk

💻 使用示例

基础用法

# 示例代码片段，具体请参考实际文档
def get_weather(city):
    pass

def geocode(address):
    pass

def search_web(query):
    pass

📚 详细文档

项目结构

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

工具介绍

• 天气查询：通过腾讯地图 API 实现天气信息查询。
• 地理编码查询：将地址转换为经纬度坐标。
• 智能网络搜索：利用智谱 AI 提供的搜索引擎进行信息检索。

开发说明

添加新工具时，请遵循以下步骤：

1. 实现功能函数。
2. 配置相关环境变量。
3. 更新项目文档。

请勿将敏感信息如 API 密钥提交到版本控制系统中。

常见问题

问题 1：连接错误

• 解决方法：检查网络连接和服务器状态。

问题 2：API 调用失败

• 解决方法：验证密钥有效性和调用频率限制。

问题 3：Web UI 无法访问

• 解决方法：检查防火墙设置和端口开放情况。

🔧 技术细节

本项目基于 MCP（模型上下文协议），集成了智谱 AI 和腾讯地图 API。通过这些集成，项目实现了天气查询、地理编码和网络搜索等功能。在开发过程中，使用 Python 语言，并且支持命令行和 Web 两种交互方式，方便用户使用。

📄 许可证

文档中未提及许可证相关信息。

致谢

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

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