使用说明
基本能力
产品定位
MCP-based Client-Server App是一个基于MCP协议的客户端-服务器应用,旨在通过LLM智能路由用户请求,支持命令执行和网络数据获取。
核心功能
- 命令执行:通过Python的
subprocess模块执行系统命令。 - 网络数据获取:使用Brave Search API获取网络搜索结果。
- 智能路由:通过LLM分析用户意图,自动选择执行命令或搜索数据。
适用场景
- 自动化任务处理:如文件操作、系统管理等。
- 快速信息检索:通过Brave Search API获取实时网络数据。
- 开发与测试:用于调试和验证命令执行和搜索功能。
工具列表
- Ollama Model:本地运行的LLM模型,支持命令解析和意图识别。
- Groq API:云LLM服务,提供高性能的意图识别能力。
- Brave Search API:用于获取网络搜索结果的API。
使用教程
使用依赖
- Python 3.x
- pip (Python包管理器)
- 虚拟环境(推荐)
- UV/UVX安装:
[UV Installation Guide](https://docs.astral.sh/uv/getting-started/installation) - Brave Search API密钥:申请链接
- LLM模型(Ollama或Groq)
安装教程
- 克隆仓库:
git clone -https://github.com/mjunaid46/mcp cd mcp - 创建并激活虚拟环境:
uv venv source .venv/bin/activate # Unix/MacOS .venv\Scripts\activate # Windows - 安装依赖:
pip install -r requirements.txt python -m ensurepip - 配置LLM模型(Ollama或Groq)和Brave Search API密钥。
调试方式
- 运行服务:或
uv run client/client.py server/command_server.py server/web_server.py ollama llama3uv run client/client.py server/command_server.py server/web_server.py groq - 测试命令:
What is the capital of Pakistan. What is MCP? Create a file in my present working directory
