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.

pip install da2-mcp-socket

Quick Start

# STDIO mode (for Cursor/Claude Desktop)
da2-mcp-socket

# HTTP mode (for Antigravity)
da2-mcp-socket --http --port 8000

Client Configuration

Cursor / Claude Desktop

{
  "mcpServers": {
    "socket": {
      "command": "da2-mcp-socket",
      "args": [],
      "env": { "LOG_LEVEL": "INFO" }
    }
  }
}

Antigravity

{
  "mcpServers": {
    "socket": {
      "serverUrl": "http://localhost:8000/mcp"
    }
  }
}

Available Tools (15)

Connection Management

Data Transmission

Protocol Management

Background Listener

Server Info

Usage Examples

RFID Reader Connection (AL-510)

# 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

# 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

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

License

MIT License

Copyright (c) 2026 Danny, DA2 Studio (https://da2.35g.tw)