关于 Custom-MCP-Server-Python
Custom-MCP-Server-Python 是用于学习 TCP 通信和协议设计的 Python socket 服务端示例。它演示结构化消息处理和客户端连接管理,可作为自定义网络应用的起点。
主要功能
- 01使用 socket 的 Python TCP 服务端
- 02结构化消息处理
- 03客户端连接管理
- 04客户端与服务端实时通信
- 05可扩展的消息类型
适用场景
- 01学习 TCP socket 编程
- 02构建自定义消息协议原型
- 03探索网络应用的服务端架构
MCP 相关
项目将自定义的 JSON over TCP 格式称为 MCP,但 README 描述的是自行定义的协议,而非 Model Context Protocol。它演示服务端对客户端消息的解析和响应。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
🧠 自定义 MCP 服务演示
本项目是使用 Python 构建的自定义 MCP(Model Context Protocol)服务,旨在演示如何创建一个使用 Model Context Protocol(MCP)进行通信的自定义服务——这是一种简单的自定义协议,可用于构建客户端与服务端之间灵活的通信系统。
📌 本项目介绍
本项目帮助你了解如何:
-
使用 Python 的 socket 库构建自定义服务
-
实现自定义协议(MCP),处理客户端与服务端之间的通信
-
以结构化的方式管理客户端连接和消息处理
-
发送和接收自定义命令与数据,并进行上下文感知处理
这是一个学习基础,可用于创建更复杂的客户端-服务端系统,例如多人游戏、聊天应用或自定义联网工具。
🚀 功能
-
🌐 使用 Python 构建的基于 TCP 的自定义服务
-
🔄 Model Context Protocol:结构化消息处理
-
📡 客户端与服务端之间的实时通信
-
🧩 易于扩展,可添加新的消息类型或功能
-
🧪 适合学习网络、协议设计和服务架构
🔧 要求
-
Python 3.8+
-
了解网络基础知识(socket、TCP)
-
无需外部依赖
🛠 如何运行
-
克隆仓库:
git clone https://github.com/Eltaf-azizi/Custom-MCP-Server-Demo.git cd custom-mcp-server -
运行服务:
python server.py
💡 MCP 协议的工作原理
Model Context Protocol 是一种自定义协议,每条消息包含:
-
模型:发送的数据类型(例如,“chat”“move”“state”)
-
上下文:帮助解读模型的附加元数据
-
数据:实际的载荷/消息
消息结构示例(通过 TCP 传输的 JSON):
{
"model": "chat",
"context": "user",
"data": "Hello, world!"
}
服务会解析这些消息并做出相应响应,从而以清晰且可扩展的方式轻松处理多种客户端交互。
📚 资源
Tech With Tim - 使用自定义 MCP 服务构建任何内容(https://www.youtube.com/watch?v=-8k9lGpGQ6g)
Python Socket 编程文档(https://docs.python.org/3/library/socket.html)
🤝 参与贡献
你可以修复并改进本项目,也可以基于它构建全新的内容。欢迎提交 PR!
祝编码愉快!
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。