da2-mcp-socket 0.2.0__tar.gz

da2_mcp_socket-0.2.0/.gitignore

@@ -0,0 +1,75 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/

da2_mcp_socket-0.2.0/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-02-05
+
+### Added
+- Background listener feature for continuous packet reception
+- `start_listening` tool: Start background listener thread
+- `stop_listening` tool: Stop background listener
+- `get_packets` tool: Get all buffered packets (clears buffer)
+- `get_buffer_status` tool: Query buffer status (count/overflow)
+- `max_buffer_packets` parameter for connect (default: 100)
+- `auto_listen` parameter for automatic background listening on connect
+- `drop_oldest` overflow policy for packet buffer
+- Thread-safe packet buffer with locking
+
+### Changed
+- Default protocol mode changed to `line` with `\r\n` end delimiter
+- Updated documentation with RFID reader (AL-510) examples
+
+---
+
+## [0.1.1] - 2026-02-05
+
+### Added
+- Protocol management feature for packet parsing
+- `set_protocol` tool: Configure receive mode (raw/line/packet) with custom delimiters
+- `receive_packet` tool: Receive complete packet based on configured protocol
+- `get_protocol` tool: Query current protocol settings
+- Support for start/end delimiters in both text and hex format
+- Packet buffering for handling partial data
+
+---
+
+
+## [0.1.0] - 2026-02-05
+
+### Added
+- Initial release
+- TCP/IP socket connection management
+- Multi-connection support with unique connection IDs
+- Data transmission (send_data, receive_data, receive_line, receive_until)
+- Text and Hex data format support
+- STDIO mode for Cursor/Claude Desktop
+- HTTP mode for Antigravity/Docker
+- Configurable timeout and buffer size settings
+- Thread-safe connection management

da2_mcp_socket-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Danny, DA2 Studio (https://da2.35g.tw)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

da2_mcp_socket-0.2.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: da2-mcp-socket
+Version: 0.2.0
+Summary: A Socket TCP/IP MCP Server - enables AI assistants to communicate via TCP/IP sockets
+Project-URL: Homepage, https://da2.35g.tw
+Project-URL: Repository, https://github.com/anthropics/mcp
+Project-URL: Documentation, https://da2.35g.tw
+Author-email: Danny <danny@35g.tw>, DA2 Studio <contact@35g.tw>
+License: MIT
+License-File: LICENSE
+Keywords: ai,claude,cursor,ip,llm,mcp,network,socket,tcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Description-Content-Type: text/markdown
+
+# Socket MCP Server
+
+A powerful Model Context Protocol (MCP) Server designed for **AI-assisted development**. It enables your AI assistant to communicate via TCP/IP sockets directly.
+
+## Key Features
+
+*   **Easy Integration**: Connect to any TCP/IP device or service
+*   **Ready to Use**: Simple `pip` installation with zero complex setup
+*   **Multi-Connection**: Manage multiple socket connections simultaneously
+*   **Packet Protocol**: Custom start/end delimiter packet parsing
+*   **Background Listener**: Auto-receive and buffer packets with drop_oldest overflow policy
+*   **Data Transmission**: Send/receive text or binary (hex) data
+*   **Dual Execution Modes**: Supports STDIO (default) and HTTP modes
+
+## Installation
+
+Ensure you have Python 3.10 or higher installed.
+
+```bash
+pip install da2-mcp-socket
+```
+
+## Quick Start
+
+```bash
+# STDIO mode (for Cursor/Claude Desktop)
+da2-mcp-socket
+
+# HTTP mode (for Antigravity)
+da2-mcp-socket --http --port 8000
+```
+
+## Client Configuration
+
+### Cursor / Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "socket": {
+      "command": "da2-mcp-socket",
+      "args": [],
+      "env": { "LOG_LEVEL": "INFO" }
+    }
+  }
+}
+```
+
+### Antigravity
+
+```json
+{
+  "mcpServers": {
+    "socket": {
+      "serverUrl": "http://localhost:8000/mcp"
+    }
+  }
+}
+```
+
+---
+
+## Available Tools (15)
+
+### Connection Management
+| Tool | Description |
+| :--- | :--- |
+| **connect** | Connect to a TCP server (host:port) |
+| **disconnect** | Close a specific connection |
+| **get_connection_status** | Get status of active connection(s) |
+
+### Data Transmission
+| Tool | Description |
+| :--- | :--- |
+| **send_data** | Send text or hex data through a connection |
+| **receive_data** | Receive data from a connection (with timeout) |
+| **receive_line** | Receive a line (until newline character) |
+| **receive_until** | Receive until a specific terminator |
+
+### Protocol Management
+| Tool | Description |
+| :--- | :--- |
+| **set_protocol** | Configure receive mode (raw/line/packet) with custom delimiters |
+| **receive_packet** | Receive complete packet based on configured protocol |
+| **get_protocol** | Get current protocol settings for a connection |
+
+### Background Listener
+| Tool | Description |
+| :--- | :--- |
+| **start_listening** | Start background listener thread |
+| **stop_listening** | Stop background listener |
+| **get_packets** | Get all buffered packets (clears buffer) |
+| **get_buffer_status** | Query buffer status (count/overflow) |
+
+### Server Info
+| Tool | Description |
+| :--- | :--- |
+| **get_server_info** | Get server version and default settings |
+
+---
+
+## Usage Examples
+
+### RFID Reader Connection (AL-510)
+
+```python
+# 1. Connect to device
+connect("192.168.248.70", 1001)
+
+# 2. Set packet protocol: <0x0A>[data]<0x0D0A>
+set_protocol("conn_id", mode="packet", 
+             start_delimiter_hex="0A", 
+             end_delimiter_hex="0D0A")
+
+# 3. Send command (Inventory EPC+TID)
+send_data("conn_id", "0A4055322C52322C302C360D", as_hex=True)
+
+# 4. Receive packet
+receive_packet("conn_id", timeout=5.0)
+# → @2000/01/01 01:31:11.981-Antenna1-U3000E300...,RE28069952...
+
+# 5. Disconnect
+disconnect("conn_id")
+```
+
+### Background Continuous Listening
+
+```python
+# 1. Connect and set protocol
+connect("192.168.248.70", 1001, max_buffer_packets=100)
+set_protocol("conn_id", mode="packet", start_delimiter_hex="0A", end_delimiter_hex="0D0A")
+
+# 2. Start background listener
+start_listening("conn_id")
+
+# 3. Get accumulated packets anytime
+get_packets("conn_id")
+# → { packets: [{data_hex, data_text, timestamp}, ...], count: 5 }
+
+# 4. Query buffer status
+get_buffer_status("conn_id")
+# → { buffer: { count: 5, max: 100, overflow_count: 0 } }
+
+# 5. Stop listening
+stop_listening("conn_id")
+```
+
+### HTTP Request
+
+```python
+connect("example.com", 80)
+send_data("conn_id", "GET / HTTP/1.1\r\nHost: example.com\r\n\r\n")
+receive_data("conn_id", size=4096, timeout=5.0)
+disconnect("conn_id")
+```
+
+---
+
+## Default Settings
+
+| Parameter | Default Value |
+| :--- | :--- |
+| **Connection Timeout** | 10.0 seconds |
+| **Read Timeout** | 5.0 seconds |
+| **Buffer Size** | 4096 bytes |
+| **Max Buffer Packets** | 100 |
+| **Overflow Policy** | drop_oldest |
+
+---
+
+## License
+
+MIT License
+
+Copyright (c) 2026 Danny, DA2 Studio (https://da2.35g.tw)
+

da2_mcp_socket-0.2.0/README.md

@@ -0,0 +1,176 @@
+# Socket MCP Server
+
+A powerful Model Context Protocol (MCP) Server designed for **AI-assisted development**. It enables your AI assistant to communicate via TCP/IP sockets directly.
+
+## Key Features
+
+*   **Easy Integration**: Connect to any TCP/IP device or service
+*   **Ready to Use**: Simple `pip` installation with zero complex setup
+*   **Multi-Connection**: Manage multiple socket connections simultaneously
+*   **Packet Protocol**: Custom start/end delimiter packet parsing
+*   **Background Listener**: Auto-receive and buffer packets with drop_oldest overflow policy
+*   **Data Transmission**: Send/receive text or binary (hex) data
+*   **Dual Execution Modes**: Supports STDIO (default) and HTTP modes
+
+## Installation
+
+Ensure you have Python 3.10 or higher installed.
+
+```bash
+pip install da2-mcp-socket
+```
+
+## Quick Start
+
+```bash
+# STDIO mode (for Cursor/Claude Desktop)
+da2-mcp-socket
+
+# HTTP mode (for Antigravity)
+da2-mcp-socket --http --port 8000
+```
+
+## Client Configuration
+
+### Cursor / Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "socket": {
+      "command": "da2-mcp-socket",
+      "args": [],
+      "env": { "LOG_LEVEL": "INFO" }
+    }
+  }
+}
+```
+
+### Antigravity
+
+```json
+{
+  "mcpServers": {
+    "socket": {
+      "serverUrl": "http://localhost:8000/mcp"
+    }
+  }
+}
+```
+
+---
+
+## Available Tools (15)
+
+### Connection Management
+| Tool | Description |
+| :--- | :--- |
+| **connect** | Connect to a TCP server (host:port) |
+| **disconnect** | Close a specific connection |
+| **get_connection_status** | Get status of active connection(s) |
+
+### Data Transmission
+| Tool | Description |
+| :--- | :--- |
+| **send_data** | Send text or hex data through a connection |
+| **receive_data** | Receive data from a connection (with timeout) |
+| **receive_line** | Receive a line (until newline character) |
+| **receive_until** | Receive until a specific terminator |
+
+### Protocol Management
+| Tool | Description |
+| :--- | :--- |
+| **set_protocol** | Configure receive mode (raw/line/packet) with custom delimiters |
+| **receive_packet** | Receive complete packet based on configured protocol |
+| **get_protocol** | Get current protocol settings for a connection |
+
+### Background Listener
+| Tool | Description |
+| :--- | :--- |
+| **start_listening** | Start background listener thread |
+| **stop_listening** | Stop background listener |
+| **get_packets** | Get all buffered packets (clears buffer) |
+| **get_buffer_status** | Query buffer status (count/overflow) |
+
+### Server Info
+| Tool | Description |
+| :--- | :--- |
+| **get_server_info** | Get server version and default settings |
+
+---
+
+## Usage Examples
+
+### RFID Reader Connection (AL-510)
+
+```python
+# 1. Connect to device
+connect("192.168.248.70", 1001)
+
+# 2. Set packet protocol: <0x0A>[data]<0x0D0A>
+set_protocol("conn_id", mode="packet", 
+             start_delimiter_hex="0A", 
+             end_delimiter_hex="0D0A")
+
+# 3. Send command (Inventory EPC+TID)
+send_data("conn_id", "0A4055322C52322C302C360D", as_hex=True)
+
+# 4. Receive packet
+receive_packet("conn_id", timeout=5.0)
+# → @2000/01/01 01:31:11.981-Antenna1-U3000E300...,RE28069952...
+
+# 5. Disconnect
+disconnect("conn_id")
+```
+
+### Background Continuous Listening
+
+```python
+# 1. Connect and set protocol
+connect("192.168.248.70", 1001, max_buffer_packets=100)
+set_protocol("conn_id", mode="packet", start_delimiter_hex="0A", end_delimiter_hex="0D0A")
+
+# 2. Start background listener
+start_listening("conn_id")
+
+# 3. Get accumulated packets anytime
+get_packets("conn_id")
+# → { packets: [{data_hex, data_text, timestamp}, ...], count: 5 }
+
+# 4. Query buffer status
+get_buffer_status("conn_id")
+# → { buffer: { count: 5, max: 100, overflow_count: 0 } }
+
+# 5. Stop listening
+stop_listening("conn_id")
+```
+
+### HTTP Request
+
+```python
+connect("example.com", 80)
+send_data("conn_id", "GET / HTTP/1.1\r\nHost: example.com\r\n\r\n")
+receive_data("conn_id", size=4096, timeout=5.0)
+disconnect("conn_id")
+```
+
+---
+
+## Default Settings
+
+| Parameter | Default Value |
+| :--- | :--- |
+| **Connection Timeout** | 10.0 seconds |
+| **Read Timeout** | 5.0 seconds |
+| **Buffer Size** | 4096 bytes |
+| **Max Buffer Packets** | 100 |
+| **Overflow Policy** | drop_oldest |
+
+---
+
+## License
+
+MIT License
+
+Copyright (c) 2026 Danny, DA2 Studio (https://da2.35g.tw)
+

da2_mcp_socket-0.2.0/README_TW.md

@@ -0,0 +1,176 @@
+# Socket MCP Server
+
+一款強大的 Model Context Protocol (MCP) 伺服器，專為 **AI 輔助開發** 設計。讓您的 AI 助手能夠直接通過 TCP/IP Socket 進行通訊。
+
+## 主要功能
+
+*   **簡易整合**：連接到任何 TCP/IP 設備或服務
+*   **即裝即用**：簡單的 `pip` 安裝，無需複雜設定
+*   **多連線支援**：同時管理多個 Socket 連線
+*   **封包協議**：支援自訂起始/結束分隔符號的封包解析
+*   **背景監聽**：自動接收並緩衝封包，支援 drop_oldest 溢出策略
+*   **資料傳輸**：發送/接收文字或二進位（Hex）資料
+*   **雙模式執行**：支援 STDIO（預設）和 HTTP 模式
+
+## 安裝
+
+請確保已安裝 Python 3.10 或更高版本。
+
+```bash
+pip install da2-mcp-socket
+```
+
+## 快速開始
+
+```bash
+# STDIO 模式（給 Cursor/Claude Desktop）
+da2-mcp-socket
+
+# HTTP 模式（給 Antigravity）
+da2-mcp-socket --http --port 8000
+```
+
+## 客戶端配置
+
+### Cursor / Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "socket": {
+      "command": "da2-mcp-socket",
+      "args": [],
+      "env": { "LOG_LEVEL": "INFO" }
+    }
+  }
+}
+```
+
+### Antigravity
+
+```json
+{
+  "mcpServers": {
+    "socket": {
+      "serverUrl": "http://localhost:8000/mcp"
+    }
+  }
+}
+```
+
+---
+
+## 可用工具 (15 個)
+
+### 連線管理
+| 工具 | 說明 |
+| :--- | :--- |
+| **connect** | 連接到 TCP 伺服器（host:port） |
+| **disconnect** | 關閉指定的連線 |
+| **get_connection_status** | 查詢活動連線的狀態 |
+
+### 資料傳輸
+| 工具 | 說明 |
+| :--- | :--- |
+| **send_data** | 通過連線發送文字或 Hex 資料 |
+| **receive_data** | 從連線接收資料（支援超時） |
+| **receive_line** | 接收一行（直到換行符號） |
+| **receive_until** | 接收直到指定的結束符號 |
+
+### 協議管理
+| 工具 | 說明 |
+| :--- | :--- |
+| **set_protocol** | 設定接收模式（raw/line/packet）及自訂分隔符號 |
+| **receive_packet** | 依照已設定的協議接收完整封包 |
+| **get_protocol** | 查詢連線的當前協議設定 |
+
+### 背景監聽
+| 工具 | 說明 |
+| :--- | :--- |
+| **start_listening** | 啟動背景監聽執行緒 |
+| **stop_listening** | 停止背景監聽 |
+| **get_packets** | 取得所有累積的封包（清空 buffer） |
+| **get_buffer_status** | 查詢 buffer 狀態（數量/溢出次數） |
+
+### 伺服器資訊
+| 工具 | 說明 |
+| :--- | :--- |
+| **get_server_info** | 取得伺服器版本和預設設定 |
+
+---
+
+## 使用範例
+
+### RFID 讀取器連線（AL-510）
+
+```python
+# 1. 連接設備
+connect("192.168.248.70", 1001)
+
+# 2. 設定封包協議：<0x0A>[資料]<0x0D0A>
+set_protocol("conn_id", mode="packet", 
+             start_delimiter_hex="0A", 
+             end_delimiter_hex="0D0A")
+
+# 3. 發送命令（盤點 EPC+TID）
+send_data("conn_id", "0A4055322C52322C302C360D", as_hex=True)
+
+# 4. 接收封包
+receive_packet("conn_id", timeout=5.0)
+# → @2000/01/01 01:31:11.981-Antenna1-U3000E300...,RE28069952...
+
+# 5. 關閉連線
+disconnect("conn_id")
+```
+
+### 背景持續監聽
+
+```python
+# 1. 連接並設定協議
+connect("192.168.248.70", 1001, max_buffer_packets=100)
+set_protocol("conn_id", mode="packet", start_delimiter_hex="0A", end_delimiter_hex="0D0A")
+
+# 2. 啟動背景監聽
+start_listening("conn_id")
+
+# 3. 隨時取得累積的封包
+get_packets("conn_id")
+# → { packets: [{data_hex, data_text, timestamp}, ...], count: 5 }
+
+# 4. 查詢 buffer 狀態
+get_buffer_status("conn_id")
+# → { buffer: { count: 5, max: 100, overflow_count: 0 } }
+
+# 5. 停止監聽
+stop_listening("conn_id")
+```
+
+### HTTP 請求
+
+```python
+connect("example.com", 80)
+send_data("conn_id", "GET / HTTP/1.1\r\nHost: example.com\r\n\r\n")
+receive_data("conn_id", size=4096, timeout=5.0)
+disconnect("conn_id")
+```
+
+---
+
+## 預設設定
+
+| 參數 | 預設值 |
+| :--- | :--- |
+| **連線超時** | 10.0 秒 |
+| **讀取超時** | 5.0 秒 |
+| **緩衝區大小** | 4096 位元組 |
+| **最大封包數** | 100 個 |
+| **溢出策略** | drop_oldest |
+
+---
+
+## 授權
+
+MIT License
+
+Copyright (c) 2026 Danny, DA2 Studio (https://da2.35g.tw)
+