MCP Server Demo - ClienteDB

MCP Server Demo - ClienteDB

これは、クライアント管理のために SQLite との統合を実演する MCP サーバーのサンプルです。

機能

サーバーは次のツールを提供します。

1. contar_clientes(): 登録されているクライアントの合計数を返します
2. buscar_cliente_por_nome(nome): 名前でクライアントを検索します（一部一致検索）
3. buscar_clientes_por_bairro(bairro): 指定した地域のクライアントをすべて検索します

使用方法

1. 仮想環境を作成して有効化します。

# Criar ambiente virtual
python3 -m venv .venv

# Ativar ambiente virtual
# No Windows:
.venv\Scripts\activate
# No macOS/Linux:
source .venv/bin/activate

2. 依存関係をインストールします。

pip install -r requirements.txt # instalar no ambiente virtual

python3.12 -m pip install -r requirements.txt --break-system-packages  # Instalar máquina física

3. サンプルデータを生成します。

python generate_sample_data.py

4. MCP サーバーを起動します。

mcp dev server.py # para usar mcp inspector
mcp install server.py --name "ClientesMCP" # instala o mcp no claude desktop

python mcp_server.py # para usar pelo protocolo sse

完了したら、仮想環境を無効化します。

deactivate

データベース構造

clientes テーブルには、次のフィールドが含まれています。

• id (INTEGER, PRIMARY KEY)
• nome (TEXT)
• email (TEXT)
• telefone (TEXT)
• bairro (TEXT)
• endereco (TEXT)

利用可能な地域

サンプルデータには、次の地域に住むクライアントが含まれています。

• Centro
• Jardim América
• Vila Nova
• Bela Vista