Skip to content
MCP server

XTELL Serial

Desktop serial terminal that AI assistants drive over MCP to read logs and send commands

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Windows, self-hosted
Runs
Locally
Version
0.1.1
Listing updated
2 days ago

About XTELL Serial

XTELL Serial is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Unlike headless serial servers, this one is a full desktop terminal, and the MCP server is a second way of driving the same window. You watch the log scroll while the assistant works, so a wrong baud rate shows up as garbage immediately, and you can type a command yourself at any time and hand control back.

The terminal handles baud rates up to 10 Mbaud, UTF-8, GBK, GB2312 and ASCII, hex view and send, timestamps, live filtering by substring or regular expression, and a 100,000-line buffer. Several named windows can run at once for benches with more than one board, and the assistant addresses a port by window name. The GUI and the MCP server talk over a local TCP hub bound to 127.0.0.1 only.

The project is an early preview at v0.1 and currently Windows only. The author warns that the assistant can send arbitrary bytes to whatever is on the port, so it should not be connected to hardware where an unexpected command could cause harm. Licensed under Apache 2.0, from an embedded design house in Shenzhen.

Install

Run in a terminal

claude mcp add xtell-serial -- npx -y https://github.com/xtell-cn/xtell-serial/releases/download/v0.1.1/xtell-serial-0.1.1.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "xtell-serial": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xtell-cn/xtell-serial/releases/download/v0.1.1/xtell-serial-0.1.1.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "xtell-serial": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xtell-cn/xtell-serial/releases/download/v0.1.1/xtell-serial-0.1.1.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "xtell-serial": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xtell-cn/xtell-serial/releases/download/v0.1.1/xtell-serial-0.1.1.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "xtell-serial": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xtell-cn/xtell-serial/releases/download/v0.1.1/xtell-serial-0.1.1.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "xtell-serial": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xtell-cn/xtell-serial/releases/download/v0.1.1/xtell-serial-0.1.1.mcpb"
      ]
    }
  }
}

What it does

Shared terminal window
You and the assistant see the same scrolling log and can take turns sending commands.
14 MCP tools
List ports, connect, send, auto-send, read received, sent or filtered data, set filters, save to file and check buffers.
Live filtering
Filter by substring or regex with highlighting and a separate filtered view.
Multiple named windows
Each window has its own name so several boards on different ports stay readable.
Text and hex
Supports hex view and send, several text encodings and timestamps.
Local-only hub
The GUI and MCP server connect over a hub on 127.0.0.1 and nothing listens on a public interface.

Good for

  • Capture a boot sequence and have an assistant explain a repeating reboot
  • Send an AT command and read the module's version reply
  • Filter a long device log for error lines
  • Monitor a gateway board and a sensor node side by side
  • Save a captured session to a file for later analysis

Pricing

Open source

Apache 2.0

Prices change. Check xtell.cn before you buy.

XTELL Serial FAQ

Which operating systems does it support?

The README says Windows only for now, in an early v0.1 preview.

Which file do I register as the MCP server?

Register xtell-serial-mcp.exe, not the GUI executable.

Is it safe to connect to any device?

No. The assistant can send arbitrary bytes to whatever is on the port, so avoid hardware where an unexpected command could cause harm.

What licence is it under?

Apache License 2.0.

Is the interface available in Chinese?

Yes, the interface switches between English and Chinese from the menu bar.

Is XTELL Serial free?

Yes. XTELL Serial is open source, so you can use and self-host it for free.

How do I add XTELL Serial to Claude Code?

Run this command in your terminal: claude mcp add xtell-serial -- npx -y https://github.com/xtell-cn/xtell-serial/releases/download/v0.1.1/xtell-serial-0.1.1.mcpb

What are the best alternatives to XTELL Serial?

The closest alternatives to XTELL Serial are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to XTELL Serial

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools