MCP Python Demo

🚀 MCP Python Sample Project

This is a project based on MCP (Model Context Protocol), integrating Zhipu AI and Tencent Maps API. It offers functions such as weather queries, geocoding, and web searches. The project supports both command-line and web interfaces for interaction.

✨ Features

• 🤖 Zhipu AI-powered dialogue system
• 🌤️ Weather query using Tencent Maps API
• 🗺️ Geocoding query
• 🔍 Intelligent web search
• 💻 Dual support for command-line and web interfaces
• 🌐 Support for external network access

📦 Project Structure

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

🚀 Quick Start

Environment Requirements

• Python >= 3.10
• uv (recommended) or pip

Installation Steps

# Example installation command, refer to the actual documentation for details
pip install mcp-sdk

Configuration Instructions

The project requires the setup of some configuration files and environment variables. Please refer to the relevant documentation to complete the configuration.

Running Methods

# Example running command, refer to the actual documentation for details
python server.py

📚 Tool Introduction

• Weather Query: Query weather information through the Tencent Maps API.
• Geocoding Query: Convert addresses to latitude and longitude coordinates.
• Intelligent Web Search: Conduct information retrieval using the search engine provided by Zhipu AI.

💻 Usage Examples

# Example code snippets, refer to the actual documentation for details
def get_weather(city):
    pass

def geocode(address):
    pass

def search_web(query):
    pass

🔧 Development Instructions

When adding new tools, please follow these steps:

1. Implement the functional functions.
2. Configure the relevant environment variables.
3. Update the project documentation.

Do not commit sensitive information such as API keys to the version control system.

❓ Frequently Asked Questions

Question 1: Connection Error

• Solution: Check the network connection and server status.

Question 2: API Call Failure

• Solution: Verify the validity of the key and the call frequency limit.

Question 3: Unable to Access the Web UI

• Solution: Check the firewall settings and port opening status.

🙏 Acknowledgments

This project is based on the following open-source projects:

• Model Context Protocol Servers - The official reference implementation of MCP servers, providing rich examples and best practices.
• MCP Python SDK - The Python SDK implementation, offering a concise and elegant API interface.