whatisgithub

What is funf-sosexy-mcp?

ktktktkt1234/funf-sosexy-mcp — explained in plain English

Analysis updated 2026-05-18

7HTMLAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

An unofficial bridge that lets an AI assistant remotely control a specific Bluetooth personal device via MCP.

Mindmap

mindmap
  root((funf-sosexy-mcp))
    What it does
      Bridges AI to Bluetooth device
      Uses MCP protocol
      Relays via Android Chrome
    Tech stack
      Python
      FastMCP
      Web Bluetooth
      Caddy
    Use cases
      Remote device control
      Self-hosted MCP server
      Bluetooth relay
    Audience
      Developers
      Hobbyist tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI chat client send remote commands to a specific Bluetooth device through MCP.

USE CASE 2

Relay Bluetooth commands from a server to a device using an Android phone as a bridge.

USE CASE 3

Deploy a self-hosted MCP server on a VPS with token-based access protection.

USE CASE 4

Check the last command status sent to a connected Bluetooth device.

What is it built with?

PythonHTMLFastMCPWeb BluetoothCaddysystemd

How does it compare?

ktktktkt1234/funf-sosexy-mcppajkegit/epic-sword-forgeronit049/find-the-perfect-blinkit-location
Stars777
LanguageHTMLHTMLHTML
Setup difficultyhardeasyeasy
Complexity4/51/51/5
Audiencedeveloperdesignerpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a VPS, a domain, an Android phone for the Bluetooth relay, and a security token before any public deployment.

You can use, modify, and share this freely, including commercially, as long as you keep the copyright notice.

So what is it?

funf-sosexy-mcp is an unofficial bridge that lets an AI assistant remotely control a Bluetooth-connected personal device made by the FUNF brand, identified over Bluetooth as SOSEXY. It works through MCP, a protocol that lets AI clients call external tools, so an AI chat client can send commands to the physical device through this project's server. The setup has three parts working together. A VPS, meaning a rented cloud server, runs the MCP service that the AI client talks to over HTTPS. An Android phone running Chrome opens a control web page, connects to the device over Bluetooth using the browser's Web Bluetooth feature, and repeatedly checks the server for new commands to forward over Bluetooth. An iPhone or computer can be used to talk to the MCP server itself, but only an Android phone can act as the Bluetooth relay to the physical device, because Web Bluetooth is not supported the same way on those platforms. Deployment involves installing Python dependencies on the VPS, copying server and web files into place, generating a random access token to protect the server, setting up the service to run continuously with systemd, and configuring a Caddy web server for HTTPS. Once running, a person opens the control page on their Android phone, enters the access token, and connects to the device, while separately configuring their AI client to reach the MCP endpoint. The available remote commands let the AI set intensity and mode for a few different functions, stop everything, or check the status of the last command sent, though the README notes this status check does not reflect manual changes made directly on the phone. The project describes its Bluetooth protocol as reverse engineered by the community rather than officially documented, states it only works with this specific device model, and warns that use is at the user's own risk. It requires a security token to be set before deploying it publicly, and is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me deploy funf-sosexy-mcp on a VPS with Caddy and systemd.
Prompt 2
Explain how the Android Chrome control page relays Bluetooth commands in this project.
Prompt 3
Walk me through generating and setting the API token for funf-sosexy-mcp.
Prompt 4
What are the known limitations of the get_status command in this project?

Frequently asked questions

What is funf-sosexy-mcp?

An unofficial bridge that lets an AI assistant remotely control a specific Bluetooth personal device via MCP.

What language is funf-sosexy-mcp written in?

Mainly HTML. The stack also includes Python, HTML, FastMCP.

What license does funf-sosexy-mcp use?

You can use, modify, and share this freely, including commercially, as long as you keep the copyright notice.

How hard is funf-sosexy-mcp to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is funf-sosexy-mcp for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.