Serial Hardware Bridge

MCPAI代理

提供方 未标注

AI代理 HTTP · 远程 未标注 社区 / 第三方
查看接入方式

全面解析Serial Hardware BridgeMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器,Serial Hardware Bridge能让AI助手访问实时数据、执行操作,为您提供更智能的工作体验和自动化解决方案。

一句话选型结论

按资料字段整理

Serial Hardware Bridge 属于AI代理类 MCP 服务器,HTTP · 远程,鉴权方式未标注,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式HTTP · 远程 鉴权未标注 部署方式远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

安装与配置

HTTP · 远程 未标注
连远程 HTTPS 端点,通常为 Streamable HTTP
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Serial Hardware Bridge当前 未标注 HTTP · 远程 远程部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类AI代理本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.8 KB
来自项目仓库与上游目录的原文,未做删改

mcp2tcp: 连接物理世界与AI大模型的桥梁

English | 简体中文

通过自然语言控制硬件,开启物联网新纪元

系统架构

mcp2tcp 系统架构图

工作流程

mcp2tcp 工作流程图

项目愿景

mcp2tcp 将TCP设备接入AI大模型的项目,它通过 Model Context Protocol (MCP) 将物理世界与 AI 大模型无缝连接。最终实现:
- 用自然语言控制你的硬件设备
- AI 实时响应并调整物理参数
- 让你的设备具备理解和执行复杂指令的能力

主要特性

  • 智能TCP通信
  • 自动检测和配置TCP设备 用户也可指定TCP号
  • 支持多种波特率(默认 115200)
  • 实时状态监控和错误处理

  • MCP 协议集成

  • 完整支持 Model Context Protocol
  • 支持资源管理和工具调用
  • 灵活的提示词系统

支持的客户端

mcp2tcp 支持所有实现了 MCP 协议的客户端,包括:

客户端 特性支持 说明
Claude Desktop 完整支持 推荐使用,支持所有 MCP 功能
Continue 完整支持 优秀的开发工具集成
Cline 资源+工具 支持多种 AI 提供商
Zed 基础支持 支持提示词命令
Sourcegraph Cody 资源支持 通过 OpenCTX 集成
Firebase Genkit 部分支持 支持资源列表和工具

支持的 AI 模型

得益于灵活的客户端支持,mcp2tcp 可以与多种 AI 模型协同工作:

云端模型

  • OpenAI (GPT-4, GPT-3.5)
  • Anthropic Claude
  • Google Gemini
  • AWS Bedrock
  • Azure OpenAI
  • Google Cloud Vertex AI

本地模型

  • LM Studio 支持的所有模型
  • Ollama 支持的所有模型
  • 任何兼容 OpenAI API 的模型

准备

Python3.11 或更高版本
Claude Desktop 或 Cline

快速开始

1. 安装

Windows用户

下载 install.py```bash
python install.py

#### macOS用户```bash
# 下载安装脚本
curl -O https://raw.githubusercontent.com/mcp2everything/mcp2tcp/main/install_macos.py

# 运行安装脚本
python3 install_macos.py

Ubuntu/Raspberry Pi用户```bash

下载安装脚本

curl -O https://raw.githubusercontent.com/mcp2everything/mcp2tcp/main/install_ubuntu.py

运行安装脚本

python3 install_ubuntu.py


安装脚本会自动完成以下操作:
- ✅ 检查系统环境
- ✅ 安装必要的依赖
- ✅ 创建默认配置文件
- ✅ 配置Claude桌面版(如果已安装)
- ✅ 检查TCP设备

### 手动分步安装依赖```bash
windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
MacOS
curl -LsSf https://astral.sh/uv/install.sh | sh

主要依赖uv工具,所以当python和uv以及Claude或Cline安装好后就可以了。

基本配置

在你的 MCP 客户端(如 Claude Desktop 或 Cline)配置文件中添加以下内容:
注意:如果使用的自动安装那么会自动配置Calude Desktop无需此步。
使用默认配置文件:```json
{
"mcpServers": {
"mcp2tcp": {
"command": "uvx",
"args": [
"mcp2tcp"
]
}
}
}

> 注意:修改配置后需要重启Cline或者Claude客户端软件

配置TCP和命令:
注意下面的配置默认为COM11 需要根据实际进行修改```yaml
# config.yaml
tcp:
  # TCP服务器配置
  remote_ip: "127.0.0.1"  # 远端IP地址
  port: 9999  # 端口号
  connect_timeout: 3.0  # 连接超时时间,单位为秒
  receive_timeout: 2.0  # 接收超时时间,单位为秒
  communication_type: "client"  # 通信类型,client或server
  response_start_string: "CMD"  # 可选,TCP应答的开始字符串,默认为OK

commands:
  # PWM控制命令
  set_pwm:
    command: "CMD_PWM {frequency}"  # frequency为0-100的整数,表示PWM占空比
    need_parse: false  # 不需要解析响应内容
    data_type: "ascii"  # 数据类型,ascii或hex
    parameters:
      - name: "frequency"
        type: "integer"
        description: "PWM frequency value (0-100)"
        required: true
    prompts:
      - "把PWM调到最大 (frequency=100)"
      - "把PWM调到最小 (frequency=0)"
      - "请将PWM设置为{frequency} (0-100的整数)"
      - "关闭PWM (frequency=0)"
      - "把PWM调到一半 (frequency=50)"

配置说明

配置文件位置

配置文件(config.yaml)可以放在位置:
用户主目录(推荐个人使用)```bash

Windows系统

C:\Users\用户名.mcp2tcp\config.yaml

macOS系统

/Users/用户名/.mcp2tcp/config.yaml

Linux系统

/home/用户名/.mcp2tcp/config.yaml

- 适用场景:个人配置
- 需要创建 `.mcp2tcp` 目录:```bash
  # Windows系统(在命令提示符中)
  mkdir "%USERPROFILE%\.mcp2tcp"

  # macOS/Linux系统
  mkdir -p ~/.mcp2tcp
  ```

### TCP配置 命令配置进阶
在 `config.yaml` 中添加自定义命令:

使用真实TCP```yaml
# config.yaml
 # PICO信息查询命令
  get_pico_info:
    command: "CMD_PICO_INFO"  # 实际发送的命令格式,server会自动添加\r\n
    need_parse: true  # 需要解析响应内容
    data_type: "ascii"  # 数据类型,ascii或hex
    prompts:
      - "查询Pico板信息"
      - "显示开发板状态"

指定配置文件:
比如指定加载Pico配置文件:Pico_config.yaml```json
{
"mcpServers": {
"mcp2tcp": {
"command": "uvx",
"args": [
"mcp2tcp",
"--config",
"Pico" //指定配置文件名,不需要添加_config.yaml后缀
]
}
}
}

为了能使用多个TCP,我们可以新增多个mcp2tcp的服务 指定不同的配置文件名即可。
如果要接入多个设备,如有要连接第二个设备:
指定加载Pico2配置文件:Pico2_config.yaml```json
{
    "mcpServers": {
        "mcp2tcp2": {
            "command": "uvx",
            "args": [
                "mcp2tcp",
                "--config",
                "Pico2"  //指定配置文件名,不需要添加_config.yaml后缀
            ]
        }
    }
}

测试

在开始使用之前,建议先进行测试以确保一切正常工作。

1. 启动测试服务器

首先,启动测试目录下的 TCP 服务器来模拟硬件设备:```bash

进入项目目录

cd tests

启动测试服务器

python tcp_server.py


服务器将在本地启动,监听端口 9999。你会看到类似这样的输出:```
TCP server started on 127.0.0.1:9999
Waiting for connections...

启动客户端Claude 桌面版或Cline

Example in Cline

从源码快速开始

  1. 从源码安装```bash

通过源码安装:

git clone https://github.com/mcp2everything/mcp2tcp.git
cd mcp2tcp

创建虚拟环境

uv venv .venv

激活虚拟环境

Windows:

.venv\Scripts\activate

Linux/macOS:

source .venv/bin/activate

安装开发依赖

uv pip install --editable .


如果使用真实TCP```yaml
# config.yaml
tcp:
  # TCP服务器配置
  remote_ip: "127.0.0.1"  # 远端IP地址
  port: 9999  # 端口号
  connect_timeout: 3.0  # 连接超时时间,单位为秒
  receive_timeout: 2.0  # 接收超时时间,单位为秒
  communication_type: "client"  # 通信类型,client或server
  response_start_string: "CMD"  # 可选,TCP应答的开始字符串,默认为OK

commands:
  # PWM控制命令
  set_pwm:
    command: "CMD_PWM {frequency}"  # frequency为0-100的整数,表示PWM占空比
    need_parse: false  # 不需要解析响应内容
    data_type: "ascii"  # 数据类型,ascii或hex
    parameters:
      - name: "frequency"
        type: "integer"
        description: "PWM frequency value (0-100)"
        required: true
    prompts:
      - "把PWM调到最大 (frequency=100)"
      - "把PWM调到最小 (frequency=0)"
      - "请将PWM设置为{frequency} (0-100的整数)"
      - "关闭PWM (frequency=0)"
      - "把PWM调到一半 (frequency=50)"

MCP客户端配置

在使用支持MCP协议的客户端(如Claude Desktop或Cline)时,需要在客户端的配置文件中添加以下内容:
直接自动安装的配置方式
源码开发的配置方式

使用默认演示参数:```json

{
"mcpServers": {
"mcp2tcp": {
"command": "uv",
"args": [
"--directory",
"你的实际路径/mcp2tcp", // 例如: "C:/Users/Administrator/Documents/develop/my-mcp-server/mcp2tcp"
"run",
"mcp2tcp"
]
}
}
}

#### 指定参数文件名```json
{
    "mcpServers": {
        "mcp2tcp": {
            "command": "uv",
            "args": [
                "--directory",
                "你的实际路径/mcp2tcp",  // 例如: "C:/Users/Administrator/Documents/develop/my-mcp-server/mcp2tcp"
                "run",
                "mcp2tcp",
                "--config", // 可选参数,指定配置文件名
                "Pico"  // 可选参数,指定配置文件名,不需要添加_config.yaml后缀
            ]
        }
    }
}

配置文件位置

配置文件(config.yaml)可以放在不同位置,程序会按以下顺序查找:

1. 当前工作目录(适合开发测试)

  • 路径:./config.yaml
  • 示例:如果你在 C:\Projects 运行程序,它会查找 C:\Projects\config.yaml
  • 适用场景:开发和测试
  • 不需要特殊权限

2. 用户主目录(推荐个人使用)```bash

Windows系统

C:\Users\用户名.mcp2tcp\config.yaml

macOS系统

/Users/用户名/.mcp2tcp/config.yaml

Linux系统

/home/用户名/.mcp2tcp/config.yaml

- 适用场景:个人配置
- 需要创建 `.mcp2tcp` 目录:```bash
  # Windows系统(在命令提示符中)
  mkdir "%USERPROFILE%\.mcp2tcp"

  # macOS/Linux系统
  mkdir -p ~/.mcp2tcp
  ```

#### 3. 系统级配置(适合多用户环境)```bash
# Windows系统(需要管理员权限)
C:\ProgramData\mcp2tcp\config.yaml

# macOS/Linux系统(需要root权限)
/etc/mcp2tcp/config.yaml
  • 适用场景:多用户共享配置
  • 创建目录并设置权限:```bash
    # Windows系统(以管理员身份运行)
    mkdir "C:\ProgramData\mcp2tcp"

# macOS/Linux系统(以root身份运行)
sudo mkdir -p /etc/mcp2tcp
sudo chown root:root /etc/mcp2tcp
sudo chmod 755 /etc/mcp2tcp
```

程序会按照上述顺序查找配置文件,使用找到的第一个有效配置文件。根据你的需求选择合适的位置:
- 开发测试:使用当前目录
- 个人使用:建议使用用户主目录(推荐)
- 多用户环境:使用系统级配置(ProgramData或/etc)

  1. 运行服务器:```bash

确保已激活虚拟环境

.venv\Scripts\activate

运行服务器(使用默认配置config.yaml 案例中用的LOOP_BACK 模拟TCP,无需真实TCP和TCP设备)

uv run src/mcp2tcp/server.py
或
uv run mcp2tcp

运行服务器(使用指定配置Pico_config.yaml)

uv run src/mcp2tcp/server.py --config Pico
或
uv run mcp2tcp --config Pico
```

文档

  • 安装指南
  • API文档
  • 配置说明

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Serial Hardware Bridge 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

Serial Hardware Bridge 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Serial Hardware Bridge 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Serial Hardware Bridge 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

Serial Hardware Bridge 能提供哪些能力?

资料显示能力标签包括 物联网、Python、AI控制。具体工具清单以官方文档为准。

Serial Hardware Bridge 需要什么运行环境?

运行时为 Python;属于远程端点,不需要在本地装运行时。

Serial Hardware Bridge 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。