AI导哈

客户订单管理应用

一个基于Python的MCP协议应用，用于与Java Spring Boot后端集成，提供客户和订单的查询与管理功能。

  • by RenanStMeira
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 RenanStMeira/MCP-app-transporte

使用说明

🚀 MCP传输应用程序

📋 概览

Python MCP（模型上下文协议） 与Java Spring Boot应用程序集成。

4 基本功能：

  1. 🔍 寻找客户 列出所有注册客户
  2. 📦 搜索订单 - 列出所有已注册的订单
  3. ➕ 地籍客户 向系统添加新客户端
  4. 📝 Cadastrar Pedido 在系统中创建新请求

🛠️ 技术

  • Python 3.12 主要语言
  • MCP框架 -模型上下文协议com装饰器 @mcp.tool
  • httpx - 异步 HTTP 客户端
  • 皮丹提克 - 数据验证
  • Java春季启动 -API后端（门户8080）

清洁结构

mcp-app-transsport/
├── src/
│   ├── models/
│   │   ├── usuario.py          # Modelo Cliente simplificado
│   │   └── order.py            # Modelo Pedido simplificado
│   ├── services/
│   │   └── api_service.py      # Serviço API Java (4 métodos)
│   ├── tools/
│   │   └── transport_tools.py  # Tools MCP (não usado no servidor moderno)
│   └── server_modern.py        # 🎯 SERVIDOR PRINCIPAL (usar este!)
├── scripts/
│   ├── run.py                  # Script principal menu interativo
│   ├── tests/
│   │   └── test_all_functions.py  # Testes automatizados
│   └── utils/
│       └── diagnostic.py       # Diagnóstico da API Java
├── requirements.txt            # Dependências Python
└── README.md                   # Esta documentação

如何使用

1. 安装

# Clonar repositório
git clone https://github.com/RenanStMeira/MCP-app-transporte.git
cd MCP-app-transporte

# Criar ambiente virtual
python -m venv venv
source venv/Scripts/activate  # Windows Git Bash

# Instalar dependências
pip install -r requirements.txt

2. 验证Java API

请确保您的 Java 应用程序正在端口 8080 上运行：

curl http://localhost:8080/api/usuario

3. 测试功能

# Menu interativo (RECOMENDADO)
python scripts/run.py

# Ou testar tudo automaticamente
python scripts/tests/test_all_functions.py

# Ou diagnóstico da API Java
python scripts/utils/diagnostic.py

🤖 与 GitHub Copilot 集成

VS Code 中的设置

添加到您的 settings.json:

{
    "mcp.servers": {
        "transport-app": {
            "command": "d:\\Studies\\MCP\\mcp-app-transsport\\venv\\Scripts\\python.exe",
            "args": ["d:\\Studies\\MCP\\mcp-app-transsport\\src\\server_modern.py"],
            "cwd": "d:\\Studies\\MCP\\mcp-app-transsport",
            "env": {
                "JAVA_API_URL": "http://localhost:8080/api"
            }
        }
    }
}

如何使用

设置后， 重新输入VS代码 问一些自然的问题：

  • “我们注册了多少客户？”
  • “列出所有请求”
  • “注册一个名叫João Silva的客户”
  • “创建住宅变更请求”

🎯 详细功能

1。🔍 寻找客户

@mcp.tool()
async def buscar_clientes() -> str:
    """Lista todos os clientes cadastrados"""
  • 端点: GET /api/usuario
  • 返回客户ID、姓名、电子邮件和电话列表

2 。📦 搜索订单

@mcp.tool()
async def buscar_pedidos() -> str:
    """Lista todos os pedidos cadastrados"""
  • 端点: GET /api/pedido
  • 返回列出订单ID、描述、价值、客户和状态

3。➕ 地籍客户

@mcp.tool()
async def cadastrar_cliente(nome: str, email: str, senha: str, telefone: Optional[str] = None) -> str:
    """Cadastra novo cliente"""
  • 端点: POST /api/usuario
  • 雷克尔姓名、电子邮件、密码（可选电话）

4.📝 Cadastrar Pedido

@mcp.tool()
async def cadastrar_pedido(descricao: str, valor: Optional[float] = None, cliente_id: Optional[int] = None) -> str:
    """Cadastra novo pedido"""
  • 端点: POST /api/pedido
  • 雷克尔描述（可选值和客户ID）

🧪 睾丸

# Ativar ambiente
source venv/Scripts/activate

# Testar tudo automaticamente
python scripts/tests/test_all_functions.py

# Menu interativo para testar individualmente
python scripts/run.py

# Diagnóstico da API Java
python scripts/utils/diagnostic.py

🔧 API端点Java Esperados

用户/客户

  • GET /api/usuario 列出所有用户
  • POST /api/usuario - 注册新用户

订单

  • GET /api/pedido 列出所有订单
  • POST /api/pedido - 注册新订单

数据格式

用户 ：

{
    "idUsuario": 1,
    "nome": "João Silva", 
    "email": "joao@email.com",
    "telefone": "(11) 99999-9999"
}

请求 ：

{
    "idPedido": 1,
    "descricao": "Transporte de móveis",
    "valor": 150.00,
    "idUsuario": 1,
    "status": "PENDENTE"
}

🔍 故障排除

Java API 连接错误

# Verificar se API está rodando
curl http://localhost:8080/api/usuario

# Diagnóstico completo
python scripts/utils/diagnostic.py

问题a没有MCP/GGitHub副本

  1. 验证日志: View > Output > MCP
  2. 再保险VS代码 设置 settings.json
  3. 测试服务器: python src/server_modern.py

Python 依赖错误

# Reinstalar dependências
pip install --upgrade -r requirements.txt

# Verificar ambiente
which python  # deve apontar para venv

📞 支撑

🎉 状态

✅ 清洁和现代的设计

  • ✅ 简化结构
  • ✅ MCP现代装饰师(@mcp.tool)
  • ✅ 4 基本功能
  • ✅ 组织脚本
  • ✅ 文档已更新
  • ✅ GitHub Copilot 集成

干净，专注和专业的代码！ （2）🚀

相关 MCP