模型上下文协议系统

一个包含服务器、客户端和用户界面的模型上下文协议系统,用于处理模型通信和交互。

  • by Granth-Gupta
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 granth-gupta/model-context-protocol

使用说明

🚀 模型上下文协议-设置指南

此存储库包含 模型上下文协议(MCP) 实现有三个主要组件:MCP服务器、MCP客户端和MCP UI。按照以下步骤设置并运行整个系统。

📋 先决条件

  • Python 3.8+ 随着 uv 包管理器
  • Node.js 16+ 随着 npm
  • Git

⚡ 快速开始

1.克隆存储库

克隆https://github.com/Granth-Gupta/Model-Context-Protocol.git cd模型上下文协议


🖥️ MCP服务器

MCP服务器已经部署,可以通过以下URL访问:

📡 员工服务器: https://mcp-server-employee-273927490120.us-central1.run.app/

📡 离开服务器: https://mcp-server-leaving-273927490120.us-central1.run.app/

✅ 这些服务器已准备好使用,不需要本地设置。


🐍 MCP客户端

2.设置Python环境

导航到MCP客户端目录并安装依赖项:

cd MCP_客户端 pip安装-r要求.txt

3.运行MCP客户端

uv运行main.py

💡 客户端将连接到部署的MCP服务器,并提供与模型上下文协议交互的接口。


🎨 MCP用户界面

4.设置Node.js环境

导航到UI目录并安装依赖项:

cd MCP_UI npm安装

5.运行开发服务器

npm运行开发

🌐 用户界面将在 http://localhost:5173 (或控制台输出中指定的端口)。


📝 完成安装工作流程

按顺序执行以下步骤:

  1. 📥 克隆存储库

克隆https://github.com/Granth-Gupta/Model-Context-Protocol.git cd模型上下文协议

  1. 🐍 设置MCP客户端

cd MCP_客户端 pip安装-r要求.txt uv运行main.py

  1. 🎨 设置MCP UI (在新航站楼) cd MCP_UI npm安装 npm运行开发

🔧 服务器配置

系统配置为使用以下服务器终结点:

🏷️ 组件 🌐 URL
员工服务器 https://mcp-server-employee-273927490120.us-central1.run.app/
离开服务器 https://mcp-server-leaving-273927490120.us-central1.run.app/

🛠️ 故障排除

常见问题和解决方案:

  • 🐍 Python依赖关系:确保你有 uv 安装。如果没有,请安装它: pip安装uv

  • 📦 Node.js问题:确保你使用的是Node.js 16+,并且npm安装正确: node--版本 npm--版本

  • 🚪 端口冲突:如果使用默认端口,应用程序将自动使用替代端口


🎯 用法

所有组件运行后:

  1. 🔄 这 MCP客户端 处理核心协议通信
  2. 🖥️ 这 MCP用户界面 提供用户友好的交互界面
  3. 🌐 这 MCP服务器 处理请求并返回响应

🚀 访问web界面 通过浏览器在运行时显示的URL npm run dev 开始使用模型上下文协议系统。