内容
# MCP Server 示例 - ClienteDB
这是一个 MCP 服务器的示例，演示了与 SQLite 集成以进行客户管理。
## 功能
该服务器提供以下工具：
1. `contar_clientes()`: 返回注册客户的总数
2. `buscar_cliente_por_nome(nome)`: 按名称搜索客户（部分搜索）
3. `buscar_clientes_por_bairro(bairro)`: 搜索特定社区的所有客户
## 如何使用
1. 创建并激活虚拟环境：
```bash
# 创建虚拟环境
python3 -m venv .venv
# 激活虚拟环境
# 在 Windows 上:
.venv\Scripts\activate
# 在 macOS/Linux 上:
source .venv/bin/activate
```
2. 安装依赖项：
```bash
pip install -r requirements.txt # 在虚拟环境中安装
python3.12 -m pip install -r requirements.txt --break-system-packages # 安装在物理机上
```
3. 生成示例数据：
```bash
python generate_sample_data.py
```
4. 启动 MCP 服务器：
```bash
mcp dev server.py # 用于使用 mcp inspector
mcp install server.py --name "ClientesMCP" # 在 claude desktop 上安装 mcp
python mcp_server.py # 用于通过 sse 协议使用
```
要完成时停用虚拟环境：
```bash
deactivate
```
## 数据库结构
`clientes` 表包含以下字段：
- id (INTEGER, PRIMARY KEY)
- nome (TEXT)
- email (TEXT)
- telefone (TEXT)
- bairro (TEXT)
- endereco (TEXT)
## 可用社区
示例数据包括以下社区中的客户：
- Centro
- Jardim América
- Vila Nova
- Bela Vista
MCP 市场