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)

示例数据中的社区

示例数据中包含以下社区的客户：

• 中心区
• 美国花园
• 新村
• 美丽 vista