{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_736qjbqvc73r","handle":"atengk-mcp-server-tcp","url":"https://wellknown.network/agents/atengk-mcp-server-tcp","links":{"self":"https://wellknown.network/agents/atengk-mcp-server-tcp/record.json","html":"https://wellknown.network/agents/atengk-mcp-server-tcp","markdown":"https://wellknown.network/agents/atengk-mcp-server-tcp/record.md","api":"https://wellknown.network/api/v1/agents/atengk-mcp-server-tcp","status":"https://wellknown.network/api/v1/agents/atengk-mcp-server-tcp/status","claim":"https://wellknown.network/agents/atengk-mcp-server-tcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/atengk-mcp-server-tcp/claim.json","badge":"https://wellknown.network/agents/atengk-mcp-server-tcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/atengk-mcp-server-tcp/history","tools":"https://wellknown.network/api/v1/agents/atengk-mcp-server-tcp/tools"},"ard":{"identifier":"urn:air::server:atengk-mcp-server-tcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"atengk-mcp-server-tcp","summary":"A versatile TCP client/server proxy MCP server for LLMs","description":"# TCP MCP Server\n\n<p align=\"center\">\n  <strong>通用 TCP 协议代理与自动化测试 Model Context Protocol (MCP) 服务端</strong>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/atengk/mcp-server-tcp/actions/workflows/ci.yml\">\n    <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\" />\n  </a>\n  <a href=\"https://github.com/atengk/mcp-server-tcp/releases\">\n    <img src=\"https://img.shields.io/github/v/release/atengk/mcp-server-tcp?style=flat-square\" alt=\"Release\" />\n  </a>\n  <a href=\"https://pypi.org/project/atengk-mcp-server-tcp/\">\n    <img src=\"https://img.shields.io/pypi/v/atengk-mcp-server-tcp?style=flat-square\" alt=\"PyPI\" />\n  </a>\n  <a href=\"./LICENSE\">\n    <img src=\"https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square\" alt=\"License\" />\n  </a>\n  <a href=\"./CONTRIBUTING.md\">\n    <img src=\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square\" alt=\"PRs Welcome\" />\n  </a>\n</p>\n\n---\n\n## 📖 项目简介\n\n`mcp-server-tcp` 是一个基于 Python 3.10+、Model Context Protocol 官方 SDK (`mcp`) 与 `asyncio` 的高性能通用 TCP 协议 MCP 服务端。赋能大语言模型（LLM）与任意 TCP 目标服务、IoT 工业硬件及私有二进制协议（如 Modbus、自定义二进制 RPC）进行全双工收发与自动化联调。\n\n---\n\n## ✨ 核心特性\n\n- 🎯 **双向通信全能**：不仅支持作为 TCP 客户端主动向外连接，还支持动态启动本地 **Mock Server** 被动捕获外部设备连入并模拟应答；\n- ⚡ **原生全双工并发**：采用读写锁分离架构（ADR-0005），长轮询等待接收（`recv`）时绝不阻塞并发指令下发（`send`）；\n- 🧩 **原子定界与半包保全**：独创软超时机制（Soft Timeout），定界符未达时不破坏报文流，无损保留半包缓冲（Drain Buffer）静默等待后续拼接；内置 10MB 缓冲区防 OOM 熔断门禁；\n- 🛡️ **探针并发平滑门禁**：端口批量扫描限制单次上限 128 个端口，内置 32 并发信号量，彻底规避系统套接字句柄耗尽崩溃；\n- 🔍 **内存环形流量审计**：每个连接独享 100 条环形缓冲区（Traffic Ring Buffer），提供时间戳、传输方向及 Hex/文本快照，零磁盘污染；支持标准 MCP Resource 挂载读取；\n- 🔒 **工业级安全防线**：默认拦截云厂商元数据（`169.254.169.254`）及高危保留网段，Mock Server 监听绑定受分级安全策略管辖，全方位防范 SSRF 攻击；\n- 🚀 **开箱即用与容器分发**：支持 `uvx` 零配置即开即用，同时发布多架构容器镜像至 GitHub Packages (`ghcr.io`)。\n\n---\n\n## 🛠️ 工具清单 (Tools)\n\n| 分类 | 工具名称 | 核心职责说明 |\n| :--- | :--- | :--- |\n| **网络探针** | `tcp_ping_port` | 测试指定主机端口的 TCP SYN 握手时延（毫秒）与可达性 |\n| | `tcp_port_scan…","publisher":{"name":"Ateng","url":null},"homepage":null,"repository":null,"version":"1.2.0","license":"Apache-2.0","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:atengk-mcp-server-tcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"atengk-mcp-server-tcp","registry":"pypi","observedAt":"2026-11-08T23:27:44.982Z","publishedAt":"2026-10-13T03:58:11.737243Z","latestVersion":"1.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"atengk-mcp-server-tcp","url":"https://pypi.org/project/atengk-mcp-server-tcp/","firstSeenAt":"2026-10-15T16:24:26.528Z","fetchedAt":"2026-11-08T23:26:51.838Z","normalizedAt":"2026-11-08T23:26:51.838Z"}]},"firstSeenAt":"2026-10-15T16:24:26.528Z","updatedAt":"2026-11-08T23:27:44.982Z"}