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

Custom-MCP-Server-Python

该项目是一个基于Python的自定义MCP(模型上下文协议)服务器演示,用于展示如何通过自定义协议实现客户端与服务器之间的结构化通信,适合构建灵活的网络应用如聊天室或多人游戏。

article

README

🚀 💡 自定义 MCP 服务器演示

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

🚀 快速开始

克隆仓库

git clone https://github.com/Eltaf-azizi/Custom-MCP-Server-Demo.git
cd custom-mcp-server

运行服务器

python server.py

✨ 主要特性

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

📦 安装指南

先决条件

  • Python 3.8+
  • 具备网络基础知识(套接字、TCP)
  • 无需外部依赖

💻 使用示例

基础用法

模型上下文协议(MCP)的消息结构示例(作为 JSON 通过 TCP):

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

服务器会解析这些消息并进行相应处理,方便处理多种类型的客户端交互,具有良好的可扩展性。

📚 详细文档

这个项目是关于什么的?

该项目帮助你理解如何:

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

它是构建更复杂的客户端 - 服务器系统(例如多人游戏、聊天应用程序或自定义网络工具)的基础学习平台。

协议如何工作(MCP)

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

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

📚 资源

🤝 贡献

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

help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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