mcpField
C
Custom-MCP-Server-Python

Custom-MCP-Server-Python

本地服务
github.com/Eltaf-azizi开发工具080 周前更新

关于 Custom-MCP-Server-Python

Custom-MCP-Server-Python 是用于学习 TCP 通信和协议设计的 Python socket 服务端示例。它演示结构化消息处理和客户端连接管理,可作为自定义网络应用的起点。

主要功能

  1. 01使用 socket 的 Python TCP 服务端
  2. 02结构化消息处理
  3. 03客户端连接管理
  4. 04客户端与服务端实时通信
  5. 05可扩展的消息类型

适用场景

  1. 01学习 TCP socket 编程
  2. 02构建自定义消息协议原型
  3. 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)

  • 无需外部依赖

🛠 如何运行

  1. 克隆仓库:

    git clone https://github.com/Eltaf-azizi/Custom-MCP-Server-Demo.git
    cd custom-mcp-server
    
  2. 运行服务:

    python server.py
    

💡 MCP 协议的工作原理

Model Context Protocol 是一种自定义协议,每条消息包含:

  1. 模型:发送的数据类型(例如,“chat”“move”“state”)

  2. 上下文:帮助解读模型的附加元数据

  3. 数据:实际的载荷/消息

消息结构示例(通过 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!

祝编码愉快!

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。