Hướng Dẫn Thiết Lập Model Context Protocol (MCP)
Từ Cơ Bản (Zero-Code) Đến Nâng Cao (VPS & Docker)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "D:\\Projects_GitHub",
        "C:\\Users\\Admin\\Desktop"
      ]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
      }
    },
    "sqlite": {
      "command": "uvx",
      "args": ["mcp-server-sqlite", "--db-path", "D:\\database.db"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    }
  }
}

# custom_mcp_server.py
# Cài đặt thư viện: pip install "mcp[cli]" requests

from mcp.server.fastmcp import FastMCP

# Khởi tạo MCP Server với tên định danh
mcp = FastMCP("Doanh Nghiep ERP Gateway")

@mcp.tool()
def tra_cuu_ton_kho(ma_san_pham: str) -> dict:
    """Tra cứu tồn kho thực tế và vị trí kệ hàng của sản phẩm theo mã SKU.

    Args:
        ma_san_pham: Mã SKU sản phẩm (ví dụ: 'IP16-PRO', 'MACBOOK-M3')
    """
    mock_db = {
        "IP16-PRO": {"ten": "iPhone 16 Pro 128GB", "ton_kho": 38, "kho": "Kệ A-02"},
        "MACBOOK-M3": {"ten": "MacBook Air M3", "ton_kho": 12, "kho": "Kệ B-05"}
    }
    sku = ma_san_pham.strip().upper()
    return mock_db.get(sku, {"error": "Không tìm thấy mã sản phẩm này"})

@mcp.tool()
def tinh_phi_giao_hang(tinh_thanh: str, can_nang_kg: float) -> dict:
    """Tính cước vận chuyển giao hàng nhanh dựa trên tỉnh thành và cân nặng."""
    gia_co_ban = 25000 if tinh_thanh.lower() in ["hà nội", "tp.hcm"] else 40000
    phi = gia_co_ban + max(0, can_nang_kg - 1) * 6000
    return {"tinh_thanh": tinh_thanh, "can_nang": can_nang_kg, "cuoc_phi_vnd": round(phi)}

if __name__ == "__main__":
    mcp.run(transport="stdio")

{
  "mcpServers": {
    "noi-bo-erp": {
      "command": "python",
      "args": ["D:\\Projects\\custom_mcp_server.py"]
    }
  }
}

# server_sse.py - Chạy trên Cloud VPS
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Enterprise Cloud MCP Gateway")

@mcp.tool()
def he_thong_status() -> dict:
    """Kiểm tra tình trạng sức khỏe máy chủ production."""
    return {"status": "healthy", "nodes": 4, "uptime": "99.98%"}

if __name__ == "__main__":
    # Lắng nghe kết nối mạng qua giao thức SSE trên cổng 8080
    mcp.run(transport="sse", host="0.0.0.0", port=8080)

# docker-compose.yml
version: '3.8'

services:
  mcp-gateway:
    build: .
    container_name: mcp-remote-gateway
    restart: always
    ports:
      - "8080:8080"
    environment:
      - PYTHONUNBUFFERED=1

{
  "mcpServers": {
    "cloud-gateway": {
      "url": "https://mcp.tencongty.com/sse"
    }
  }
}