返回 MCP 目录
public公开dns本地运行

Custom-MCP-Server-Demo

这是一个基于Python的自定义MCP(模型上下文协议)服务器演示项目,旨在展示如何构建使用自定义协议进行通信的服务器,适用于学习网络编程和协议设计。

article

README

🚀 自定义 MCP 服务器演示

该项目使用 Python 构建了一个自定义 MCP(模型上下文协议)服务器,能展示如何创建自定义服务器。此服务器采用自定义设计的 MCP 进行通信,这是一种简单又灵活的协议,适用于构建客户端与服务器之间的通信系统。

🚀 快速开始

本项目能帮助您了解以下内容:

  • 使用 Python 的 socket 库构建自定义服务器。
  • 实现自定义协议(MCP),以处理客户端和服务器之间的通信。
  • 管理客户端连接和消息处理。
  • 发送和接收带有上下文感知处理的自定义命令和数据。

它是创建更复杂的客户端 - 服务器系统的良好基础,例如多人游戏、聊天应用程序或自定义网络工具。

✨ 主要特性

  • 🌐 基于 TCP 的自定义 Python 服务器。
  • 🔄 模型上下文协议:结构化消息处理。
  • 📡 实时客户端和服务器之间通信。
  • 🧩 易于扩展新的消息类型或功能。
  • 🧪 学习网络、协议设计和服务器架构的理想选择。

🔧 系统需求

  • Python 3.8+
  • 基本了解网络(套接字、TCP)
  • 无外部依赖项要求

📦 安装指南

  1. 克隆仓库:
git clone https://github.com/Eltaf-azizi/Custom-MCP-Server-Demo.git
cd custom-mcp-server
  1. 运行服务器:
python server.py

📚 详细文档

💡 协议工作原理(MCP)

模型上下文协议是一个自定义定义的协议,其中每个消息包括:

  1. 模型:正在发送的数据类型(例如,“聊天”,“移动”,“状态”)。
  2. 上下文:帮助解释模型的附加元数据。
  3. 数据:实际的有效负载/消息。

示例消息结构(作为 JSON 进行 TCP 传输):

{
    "model": "chat",
    "context": "user",
    "data": "Hello, world!"
}

服务器解析这些消息并相应处理,使处理多种类型的客户端交互变得简单且具有扩展性。

📚 资源

🤝 贡献

您可以修复此项目,改进它或在其之上构建全新的内容。欢迎提交 PR!

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端