MCP Server Demo Clientedb

🚀 MCP 服務器演示 - 客戶端數據庫

本項目是一個示例服務器，展示瞭如何將 MCP 與 SQLite 集成，從而實現對客戶信息的高效管理。

✨ 主要特性

該服務器具備以下實用功能：

1. contar_clientes()：此函數可返回已註冊的客戶總數。
2. buscar_cliente_por_nome(nome)：支持根據姓名搜索客戶，並且支持部分匹配。
3. buscar_clientes_por_bairro(bairro)：可搜索特定社區的所有客戶。

📦 安裝指南

1. 創建並激活虛擬環境

# 創建虛擬環境
python3 -m venv .venv

# 激活虛擬環境
# 在Windows:
.venv\Scripts\activate
# 在macOS/Linux:
source .venv/bin/activate

2. 安裝依賴項

pip install -r requirements.txt # 在虛擬環境中安裝

python3.12 -m pip install -r requirements.txt --break-system-packages  # 在物理機上安裝

3. 生成示例數據

python generate_sample_data.py

4. 啟動 MCP 服務器

mcp dev server.py # 使用mcp inspector
mcp install server.py --name "ClientesMCP" # 安裝到Claude桌面

python mcp_server.py # 通過SSE協議使用

關閉虛擬環境

完成操作後，可使用以下命令關閉虛擬環境：

deactivate

📚 詳細文檔

數據庫結構

clientes 表包含以下字段：

示例數據中的社區

示例數據中包含以下社區的客戶：

• 中心區
• 美國花園
• 新村
• 美麗 vista