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