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 接口