MCP 服务器演示 - ClienteDB

这是一个 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 desktop 中安装 mcp

python mcp_server.py # 通过 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