tinysa-mcp

What is tinysa-mcp?

tinysa-mcp is an MCP server for operating a TinySA device via a serial port. It provides a tool-based interface using Python libraries (pyserial, httpx, numpy, Pillow, FastMCP) to connect to the device, execute commands, and retrieve version information.

How to use tinysa-mcp?

Run the main function to start the Tkinter GUI and MCP server in a background thread. Then invoke MCP tools using an MCP client, for example: mcp call get_version --args '{"port": "COM4"}'. Ensure the serial port is correct and that you have appropriate permissions.

Key features of tinysa-mcp

• Send commands to the TinySA and retrieve responses.
• Retrieve firmware and hardware version information.
• Exposes MCP tools for integration with other systems.
• Supports image capture from the device screen.
• Optional file saving with timestamps for captured images.
• Connects and disconnects from the device through a serial port.

Use cases of tinysa-mcp

• Automating TinySA measurements and data retrieval via an MCP client.
• Capturing device screen images for documentation or analysis.
• Integrating TinySA control into larger automated test or monitoring workflows.
• Retrieving detailed device info for status reporting or diagnostics.

FAQ from tinysa-mcp

What dependencies are required?

The project requires Python with libraries: pyserial, httpx, numpy, Pillow, and FastMCP. It also uses Tkinter for the GUI.

How do I connect to the TinySA device?

Use the connect MCP tool with the correct serial port name (e.g., "COM4"). Ensure the port is correct and that your user has permission to access it.

What if a command fails?

Check the MCP server logs for error messages. Verify the serial port is correct and that the device is properly connected. Refer to the troubleshooting section in the README.

How does image capture work?

Invoke the capture_image tool. The device must return 307200 bytes of data. Optionally, the image can be saved to a file with a timestamp.

Is the server production-ready?

The author states the project is experimental and cannot guarantee it will work properly. Use with caution.