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
安装
- 克隆项目:
git clone https://github.com/chenchen0611/mcp-python-demo.git
cd mcp-python-demo
- 使用 uv 安装依赖:
uv venv
source .venv/bin/activate # Linux/Mac
# 或
.venv\Scripts\activate # Windows
uv pip install -e .
配置
- 创建
.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,点击连接
- 新建一个terminal,运行下方命令然后在web页面输入http://127.0.0.1:8000
cd src/mcp_python_demo uv run server.py
命令行界面
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
可用工具
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进行网络搜索"""
开发说明
添加新工具
- 在
server.py中使用@mcp.tool()装饰器添加新工具:
@mcp.tool()
async def your_tool(param1: str, param2: str = "default") -> str:
"""工具描述"""
# 实现逻辑
return result
- 工具会自动在客户端可用
环境变量
- 所有敏感信息和配置都应该放在
.env文件中 - 不要将
.env文件提交到版本控制系统 - 参考
.env.example进行配置
常见问题
-
连接错误
- 检查服务器地址是否正确
- 确认所有环境变量都已正确配置
- 确保服务器正在运行且端口可访问
-
API 调用失败
- 验证 API 密钥是否有效
- 检查网络连接
- 确认 API 调用频率是否超限
-
Web UI 无法访问
- 检查防火墙设置
- 确认端口是否开放
- 验证服务器 IP 地址是否正确
致谢
本项目基于以下开源项目:
- Model Context Protocol Servers - MCP 官方服务器参考实现,提供了丰富的示例和最佳实践
- MCP Python SDK - Python SDK 实现,提供了简洁优雅的 API 接口
Metadata
Release files for iflow-mcp_mcp-python-demo 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_mcp_python_demo-0.1.0.tar.gz | 9.1 kB | Without provenance | Details for iflow_mcp_mcp_python_demo-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_mcp_python_demo-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_mcp_python_demo-0.1.0-py3-none-any.whl |
Total release size: 20.0 kB
Release files / iflow_mcp_mcp_python_demo-0.1.0.tar.gz
| Download URL | iflow_mcp_mcp_python_demo-0.1.0.tar.gz |
|---|---|
| Size | 9.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f7a096ba2f9aa784f52195fb30ea4288324920c9072dabc8e635617e14a686e5
|
|
BLAKE2b-256 checksum How to use checksums |
eb63b7842df2db42c3c94f1b0af44a72d823665384aef27290432b4d0fa3c2c5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_mcp_python_demo-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_mcp_python_demo-0.1.0-py3-none-any.whl |
|---|---|
| Size | 11.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
31514eb454bc82ce1299e362a8ed03a727ca728466a20e1656b92ab30b808a15
|
|
BLAKE2b-256 checksum How to use checksums |
456bdd94bd8da71aeaec2f0044748d808e814595ed35cfcc462910bf798abbf3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_mcp-python-demo 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.