How do I use coserial?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@coserial Open COM3 at 115200 baud and wait for ready" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

coserial

by FlipFlopszzz

Overview Schema Related Servers Score Discussions

Python

Local

coserial

简体中文 | English

Collaborative Serial Debug Bridge. Humans and AI Agents co-control serial ports via MCP tools or Web UI, sharing all IO data in real time. Humans, Agents, and hardware — all on the same page.

Architecture

Agent A ── MCP stdio ── coserial-client ──┐
Agent B ── MCP stdio ── coserial-client ──┤
Agent C ── MCP stdio ── coserial-client ──┤
...                                       │ HTTP (localhost)
Human A ── Web UI ────────────────────────┤
Human B ── Web UI ────────────────────────┤
...                                       ▼
                         coserial-server
                         ├── HTTP API (/mcp/…)     ← MCP tool calls
                         ├── WebSocket /ws         ← Web UI real-time data
                         ├── GET /                 ← Web UI (HTML/CSS/JS)
                         ├── SessionManager
                         │   ├── COM1
                         │   ├── COM2
                         │   └── ...
                         └── Web UI Monitor

Related MCP server: Serial MCP Server

Features

🤝 Human-Agent Collaboration — Humans and AI Agents share the same serial session, debugging in real time
🔌 MCP Tool Control — Agents read/write serial ports, wait for pattern matches, send commands, etc. via standard MCP protocol
🖥️ Web UI Monitor — Dark theme, real-time RX/TX data stream, HEX display, search highlighting, log export
🔄 Three-Party Data Sync — Agent I/O and Web UI I/O write to the same buffer — nobody misses anything
📡 Multi-Session Management — Connect to multiple serial ports simultaneously, switch via Web UI dropdown
🔧 Signal Line Control — DTR/RTS hardware reset support
📝 Log Persistence — Serial I/O automatically recorded to file
🎯 Zero-Build Frontend — Vanilla HTML/CSS/JS, no frontend toolchain required

Quick Start

Install

# Clone the repo
git clone https://github.com/FlipFlopszzz/coserial.git
cd coserial

# Install dependencies (requires uv)
uv sync

Launch

# Start server + open Web UI (manual debug mode)
uv run coserial

# Start and auto-connect to COM20
uv run coserial COM20

# List all active sessions
uv run coserial list

# Start server only (headless)
uv run coserial-server

MCP Tools

Tool	Description
`server()`	Discover/start server process, returns port
`open_session(port, baud)`	Create a serial session, returns session_id
`close_session(session_id)`	Close a specific session
`write(session_id, data)`	Send data to serial port
`read(session_id, timeout, size)`	Read buffer data
`wait_for(session_id, pattern, timeout)`	Wait for output matching a regex
`command(session_id, data, expect, timeout)`	Send command and wait for response
`set_params(session_id, baud, ...)`	Dynamically adjust serial parameters
`get_params(session_id)`	Get full session parameters
`set_signals(session_id, dtr, rts)`	Control DTR/RTS signal lines
`list_ports()`	List available serial ports
`list_sessions()`	List all active sessions
`web(port)`	Open Web UI in system browser
`preview(port)`	Return URL for Agent's embedded browser
`shutdown_server()`	Shut down server process

Web UI

Open http://127.0.0.1:37210/ directly in your system browser, or via any Agent tool's embedded browser.

Project Structure

coserial/
├── pyproject.toml
├── src/coserial/
│   ├── __main__.py       # Entry: uv run coserial
│   ├── client.py         # MCP stdio client → HTTP proxy to server
│   ├── server.py         # Server: HTTP API + WebSocket + Web UI
│   ├── session.py        # SessionBuffer + SerialSession + SessionManager
│   └── web_ui/
│       └── index.html    # Single-page HTML, inline CSS/JS

Dependencies

Python >= 3.11
pyserial — Serial communication
mcp — MCP SDK (FastMCP)
websockets — WebSocket server
aiohttp — HTTP server
pywin32 — Windows process management
Icons from IconPark

License

MIT License

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FlipFlopszzz/coserial'

If you have feedback or need assistance with the MCP directory API, please join our Discord server