模型上下文协议服务器

一个为Ubuntu CLI设计的简单MCP服务器和客户端实现,用于模型上下文协议通信。

  • by sgobi
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 sgobi/mcp-docker

使用说明

💡 Ubuntu的MCP(模型上下文协议)设置

为Ubuntu CLI设计的简单MCP(模型上下文协议)服务器和客户端实现。

📂 项目结构

这是MCP项目的预期文件和目录布局:

MCP/ ├── mcp env/#Python虚拟环境 ├── mcp-server.py#mcp服务器实现脚本 ├── mcp-client.py#mcp客户端实现脚本 └── README.md#此文件

🚀 快速开始

按照以下步骤快速激活您的环境并运行服务器和客户端。

  1. 激活环境并启动服务器(终端1)

打开第一个终端并运行服务器:

cd~/MCP 源mcp env/bin/activate python mcp-server.py

  1. 运行客户端(终端2)

打开第二个终端来运行客户端,客户端将尝试连接到正在运行的服务器:

cd~/MCP 源mcp env/bin/activate python mcp-client.py

🛠️ 设置和安装

这些步骤假设您的Ubuntu系统上安装了Python 3和pip。

  1. 创建项目目录

创建主目录并导航到其中

mkdir~/MCP cd~/MCP

  1. 创建和激活虚拟环境

使用虚拟环境来管理依赖关系是最佳做法:

创建虚拟环境

python3-mvenvmcp-env

激活环境

源mcp env/bin/activate

注意:您的终端提示现在应该显示(mcp-env)。

  1. 再进行

安装核心mcp库和必要的HTTP客户端库:

安装核心MCP库

pip安装mcp

安装服务器/客户端通信的网络模块(例如请求和httpx)

pip安装请求httpx

  1. 验证安装

确保mcp包在活动环境中可访问:

验证导入

python-c“导入mcp;打印(‘mcp安装成功’)”

(可选)查看详细信息

pip秀mcp pip 列表

✅ 测试

为了确保您的设置正常工作,您可以创建一个专用的测试环境并运行协议测试。

  1. 测试设置

为您的测试脚本和配置创建一个结构:

导航到主MCP目录

cd~/MCP

创建测试目录结构

mkdir-p测试/{日志、配置、脚本} 更改到测试目录

  1. 测试环境(可选,用于隔离)

如果你想要一个单独的测试环境(在主mcp环境之外):

创建用于测试的专用虚拟环境

python-m venv-mcp测试环境 源mcp测试env/bin/activate

在测试环境中安装MCP

pip安装mcp

  1. 运行测试脚本

一旦你的测试脚本(test_mcp.py)在tests/scripts目录中,你就可以运行它:

导航回主MCP目录

cd~/MCP

运行特定的测试脚本(如果不使用mcp-test-env,请确保mcp-env处于活动状态)

python3脚本/test_mcp.py

  1. 运行所有测试

如果您在测试目录中有一个测试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容器”