mcp-demo

基于MCP官方文档创建了一个简单的实现，包括MCP客户端和多个MCP服务器，支持本地文件搜索、系统控制、命令执行和在线API调用。

推荐与OneAPI/NeweAPI一起使用

环境配置

• Python 3.12（这是本地使用的版本，之前未经过测试，因此估计3.11和3.10也不会有问题）
• uv，包管理工具，易于使用！

克隆仓库：

git clone https://github.com/syuchua/mcp-demo.git
cd mcp-demo

安装依赖：

uv pip install -e .

配置您的API_KEY

• （可选）创建一个.env文件，并添加OPENAI_SPI_KEY="Your-Api-key"
• 直接编辑src/config/default_comfig.yaml

开始使用：

python main.py
# 直接用uv也行
uv run main.py

命令行交互

启动客户端后，您可以输入查询或使用以下命令：

• !help - 显示帮助信息
• !servers - 列出可用服务器
• !connect <server> - 连接到指定服务器
• !models - 列出可用的LLM模型
• !model <name> - 切换使用模型
• !debug <on/off> - 启用/禁用调试模式
• !quit 或 !exit - 退出程序

支持的服务器和工具

美国天气服务器（Weather）

• get_forecast - 获取指定坐标的天气预报
• get_alerts - 获取指定州的天气警报

高德地图服务器（Gaode）

• 地址编码/逆地址编码
• 天气查询
• 路径规划（驾车/步行/骑行/公共交通）
• POI搜索
• 地点查询

本地文件搜索服务器（everything）

• search - 基于Everything搜索引擎的文件搜索功能
• 支持各种搜索语法，包括通配符、正则表达式和高级过滤

系统工具服务器（system_tools）

• execute_program - 执行指定的程序或应用程序
• open_app - 打开常用的应用程序（如QQ、微信、浏览器等）
• send_qq_message - 发送QQ消息
• list_running_processes - 列出当前正在运行的进程
• kill_process - 结束指定的进程
• create_file - 创建并写入文件
• read_file - 读取文件内容
• list_files - 列出目录中的文件
• delete_file - 删除文件
• get_working_directory - 获取当前工作目录
• run_python_code - 执行Python代码并返回结果

示例查询

天气查询

检查旧金山的天气预报以及纽约是否有风暴警告

地图服务

查询北京明天的天气，查看杭州西湖的位置，并计算从清华大学到北京大学的步行路线

文件查找

查找所有PDF文件，查找最近修改的Python代码，找到名称为'Report'的Excel文件

文件/应用程序操作

打开记事本 创建Hello World.py文件并写入Python代码 查看当前目录下的文件 执行Python代码以计算1到100的总和 将视频D:\demo.mp4转换为MP3音频，并合并两个视频文件。从视频中提取5秒片段以创建GIF

智能服务器选择

无需手动切换服务器，只需直接提问！系统会根据查询内容自动选择最合适的服务器来处理您的请求。

自定义服务器

您可以通过修改配置文件来添加自定义服务器。

许可证

MIT许可证