使用说明
💡 Ubuntu的MCP(模型上下文协议)设置
为Ubuntu CLI设计的简单MCP(模型上下文协议)服务器和客户端实现。
📂 项目结构
这是MCP项目的预期文件和目录布局:
MCP/ ├── mcp env/#Python虚拟环境 ├── mcp-server.py#mcp服务器实现脚本 ├── mcp-client.py#mcp客户端实现脚本 └── README.md#此文件
🚀 快速开始
按照以下步骤快速激活您的环境并运行服务器和客户端。
- 激活环境并启动服务器(终端1)
打开第一个终端并运行服务器:
cd~/MCP 源mcp env/bin/activate python mcp-server.py
- 运行客户端(终端2)
打开第二个终端来运行客户端,客户端将尝试连接到正在运行的服务器:
cd~/MCP 源mcp env/bin/activate python mcp-client.py
🛠️ 设置和安装
这些步骤假设您的Ubuntu系统上安装了Python 3和pip。
- 创建项目目录
创建主目录并导航到其中
mkdir~/MCP cd~/MCP
- 创建和激活虚拟环境
使用虚拟环境来管理依赖关系是最佳做法:
创建虚拟环境
python3-mvenvmcp-env
激活环境
源mcp env/bin/activate
注意:您的终端提示现在应该显示(mcp-env)。
- 再进行
安装核心mcp库和必要的HTTP客户端库:
安装核心MCP库
pip安装mcp
安装服务器/客户端通信的网络模块(例如请求和httpx)
pip安装请求httpx
- 验证安装
确保mcp包在活动环境中可访问:
验证导入
python-c“导入mcp;打印(‘mcp安装成功’)”
(可选)查看详细信息
pip秀mcp pip 列表
✅ 测试
为了确保您的设置正常工作,您可以创建一个专用的测试环境并运行协议测试。
- 测试设置
为您的测试脚本和配置创建一个结构:
导航到主MCP目录
cd~/MCP
创建测试目录结构
mkdir-p测试/{日志、配置、脚本} 更改到测试目录
- 测试环境(可选,用于隔离)
如果你想要一个单独的测试环境(在主mcp环境之外):
创建用于测试的专用虚拟环境
python-m venv-mcp测试环境 源mcp测试env/bin/activate
在测试环境中安装MCP
pip安装mcp
- 运行测试脚本
一旦你的测试脚本(test_mcp.py)在tests/scripts目录中,你就可以运行它:
导航回主MCP目录
cd~/MCP
运行特定的测试脚本(如果不使用mcp-test-env,请确保mcp-env处于活动状态)
python3脚本/test_mcp.py
- 运行所有测试
如果您在测试目录中有一个测试shell脚本(run_tests.sh):
运行测试套件脚本
./testing/run_tests.sh
工作阿西
cd~/MCP/测试 源mcp测试env/bin/activate cd。. python mcp-assistant.py
#终端1 python docker-mcp-server.py
#终端2 python docker-mcp-client.py python docker-mcp-client.py“列出我的所有docker容器”