Overview
The tinySA_mcp project is an experimental MCP server designed to operate a TinySA device via a serial port, utilizing Python libraries for a tool-based interface.
To use tinySA_mcp, ensure Python >=3.13 is installed, install the required dependencies, and run the MCP server using the command: python tinySA_Operator.py.
- Automatic detection and connection to a TinySA device. - Send commands and retrieve responses from the device. - Retrieve firmware and hardware version information. - Disconnect the device as needed. - Exposes MCP tools for integration with other systems. - Supports image capture from the device screen, with optional file saving. - Basic troubleshooting messages for connection issues.
- Operating TinySA devices for signal analysis.
- Automating commands and retrieving data from TinySA devices.
- Capturing and saving images from the TinySA screen for documentation.
Add to your AI client
Use these steps to connect tinysa-mcp in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"tinysa-mcp-manahiyo831": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-tinysa-mcp-manahiyo831"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"tinysa-mcp-manahiyo831": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-tinysa-mcp-manahiyo831"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"tinysa-mcp-manahiyo831": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-tinysa-mcp-manahiyo831"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"tinysa-mcp-manahiyo831": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-tinysa-mcp-manahiyo831"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tinysa-mcp-manahiyo831": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-tinysa-mcp-manahiyo831"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"tinysa-mcp-manahiyo831": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-tinysa-mcp-manahiyo831"
]
}
}
}FAQ
What Python version is required?
Python >=3.13 is required to run tinySA_mcp.
How do I install the dependencies?
You can install dependencies using `hatch run build` or `pip install httpx mcp[cli]>=1.4.1 pyserial numpy Pillow`.
What should I do if I encounter connection issues?
Ensure the specified serial port is correct and that your user has appropriate permissions.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3866,"uuid":"f279b9e4-f3d7-4462-87db-c67e4b819de6","name":"tinySA_mcp","title":"tinysa-mcp","description":"This is experimental MCP server for operating tinySA.","avatar_url":"https://avatars.githubusercontent.com/u/83148498?v=4","created_at":"2025-03-22T04:35:53.501Z","updated_at":"2025-03-22T04:53:06.909Z","status":"created","author_name":"manahiyo831","author_avatar_url":"https://avatars.githubusercontent.com/u/83148498?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/manahiyo831/tinySA_mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-04-21 09:45:31\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]