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 テーブルは以下のフィールドを含みます。

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

サンプルデータ内の地区

サンプルデータには以下の地区のクライアントが含まれています。

• 中心区
• アメリカンガーデン
• 新村
• ビューティビスタ