A versatile TCP client/server proxy MCP server for LLMs
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"atengk-mcp-server-tcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# TCP MCP Server <p align="center"> <strong>通用 TCP 协议代理与自动化测试 Model Context Protocol (MCP) 服务端</strong> </p> <p align="center"> <a href="https://github.com/atengk/mcp-server-tcp/actions/workflows/ci.yml"> <img src="https://img.shields.io/github/actions/workflow/status/atengk/mcp-server-tcp/ci.yml?branch=main&label=CI&style=flat-square" alt="CI Status" /> </a> <a href="https://github.com/atengk/mcp-server-tcp/releases"> <img src="https://img.shields.io/github/v/release/atengk/mcp-server-tcp?style=flat-square" alt="Release" /> </a> <a href="https://pypi.org/project/atengk-mcp-server-tcp/"> <img src="https://img.shields.io/pypi/v/atengk-mcp-server-tcp?style=flat-square" alt="PyPI" /> </a> <a href="./LICENSE"> <img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square" alt="License" /> </a> <a href="./CONTRIBUTING.md"> <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome" /> </a> </p> --- ## 📖 项目简介 `mcp-server-tcp` 是一个基于 Python 3.10+、Model Context Protocol 官方 SDK (`mcp`) 与 `asyncio` 的高性能通用 TCP 协议 MCP 服务端。赋能大语言模型（LLM）与任意 TCP 目标服务、IoT 工业硬件及私有二进制协议（如 Modbus、自定义二进制 RPC）进行全双工收发与自动化联调。 --- ## ✨ 核心特性 - 🎯 **双向通信全能**：不仅支持作为 TCP 客户端主动向外连接，还支持动态启动本地 **Mock Server** 被动捕获外部设备连入并模拟应答； - ⚡ **原生全双工并发**：采用读写锁分离架构（ADR-0005），长轮询等待接收（`recv`）时绝不阻塞并发指令下发（`send`）； - 🧩 **原子定界与半包保全**：独创软超时机制（Soft Timeout），定界符未达时不破坏报文流，无损保留半包缓冲（Drain Buffer）静默等待后续拼接；内置 10MB 缓冲区防 OOM 熔断门禁； - 🛡️ **探针并发平滑门禁**：端口批量扫描限制单次上限 128 个端口，内置 32 并发信号量，彻底规避系统套接字句柄耗尽崩溃； - 🔍 **内存环形流量审计**：每个连接独享 100 条环形缓冲区（Traffic Ring Buffer），提供时间戳、传输方向及 Hex/文本快照，零磁盘污染；支持标准 MCP Resource 挂载读取； - 🔒 **工业级安全防线**：默认拦截云厂商元数据（`169.254.169.254`）及高危保留网段，Mock Server 监听绑定受分级安全策略管辖，全方位防范 SSRF 攻击； - 🚀 **开箱即用与容器分发**：支持 `uvx` 零配置即开即用，同时发布多架构容器镜像至 GitHub Packages (`ghcr.io`)。 --- ## 🛠️ 工具清单 (Tools) | 分类 | 工具名称 | 核心职责说明 | | :--- | :--- | :--- | | **网络探针** | `tcp_ping_port` | 测试指定主机端口的 TCP SYN 握手时延（毫秒）与可达性 | | | `tcp_port_scan…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.