Serial Hardware Bridge

🚀 MCP2TCP 服務器文檔

MCP2TCP 服務器是一個用於特定網絡通信的工具，它能實現 MCP 協議與 TCP 之間的轉換，為相關客戶端提供服務。下面將詳細介紹其安裝、配置、運行等方面的內容。

🚀 快速開始

若你想快速使用 MCP2TCP 服務器，可按以下步驟操作：

1. 完成服務器的安裝。
2. 對服務器和客戶端進行配置。
3. 運行服務器。

📦 安裝指南

安裝步驟

1. 克隆倉庫：

git clone https://github.com/your-username/mcp2tcp.git
cd mcp2tcp

2. 創建並激活虛擬環境（推薦使用 Python 3.8+）：

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`

3. 安裝依賴項：

pip install -r requirements.txt

4. 配置文件位置：

• 當前目錄（適合開發測試）：./config.yaml
• 用戶主目錄（推薦個人使用）：C:\Users\<用戶名>\.mcp2tcp\config.yaml 或 /home/<用戶名>/.mcp2tcp/config.yaml
• 系統級配置（適合多用戶環境）：C:\ProgramData\mcp2tcp\config.yaml 或 /etc/mcp2tcp/config.yaml

📚 詳細文檔

配置說明

服務器配置

編輯 config.yaml 文件：

server:
  host: "0.0.0.0"  # 監聽地址
  port: 8080        # 監聽端口
  loopback_only: false  # 是否僅使用環回接口

MCP 客戶端配置

在支持 MCP 協議的客戶端（如 Claude Desktop 或 Cline）中，添加以下內容：

{
    "mcpServers": {
        "mcp2tcp": {
            "command": "uv",
            "args": [
                "--directory",
                "你的實際路徑/mcp2tcp",  // 示例: "C:/Users/Administrator/Documents/develop/my-mcp-server/mcp2tcp"
                "run",
                "mcp2tcp"
            ]
        }
    }
}

指定參數文件名

{
    "mcpServers": {
        "mcp2tcp": {
            "command": "uv",
            "args": [
                "--directory",
                "你的實際路徑/mcp2tcp",  // 示例: "C:/Users/Administrator/Documents/develop/my-mcp-server/mcp2tcp"
                "run",
                "mcp2tcp",
                "--config",  // 可選參數，指定配置文件名
                "Pico"      // 可選參數，指定配置文件名，不需要添加 `.yaml` 後綴
            ]
        }
    }
}

運行服務器

1. 激活虛擬環境：

source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`

2. 運行服務器（使用默認配置）：

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

3. 使用指定配置文件運行：

uv run --config config.yaml

其他說明

• 項目倉庫地址：https://github.com/your-username/mcp2tcp
• 問題反饋：請通過 Issues 提交問題或建議。

感謝使用 MCP2TCP 服務器！如果有任何疑問，請隨時查閱文檔或聯繫支持團隊。