自然语言订单管理系统

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   MCP Client    │    │   MCP Server    │    │  Spring Boot    │
│ (Claude/Other)  │◄──►│  (This Demo)    │◄──►│   REST APIs     │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                                │
                                ▼
                       ┌─────────────────┐
                       │   PostgreSQL    │
                       │    Database     │
                       └─────────────────┘

git clone <repository-url>
cd spring-ai-mcp-server-demo

OPENAI_API_KEY=your-openai-api-key-here

# Start the application and database
docker-compose up --build

# The application will be available at http://localhost:8080
# PostgreSQL will be available at localhost:5432

# Start PostgreSQL (if not using Docker)
docker run --name ecommerce-postgres -e POSTGRES_DB=ecommerce_demo -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -p 5432:5432 -d postgres:15

# Run the application
./gradlew bootRun

# 1. Create customer
curl -X POST http://localhost:8080/api/customers \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phone": "+1-555-0123",
    "address": {
      "street": "123 Main St",
      "city": "New York",
      "state": "NY",
      "zipCode": "10001",
      "country": "USA"
    }
  }'

# 2. Create products
curl -X POST http://localhost:8080/api/products \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MacBook Pro",
    "description": "Apple MacBook Pro 16-inch",
    "price": 2499.99,
    "category": "Electronics",
    "sku": "MBP-16-001",
    "stockQuantity": 10
  }'

# 3. Create order
curl -X POST http://localhost:8080/api/orders \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": 1,
    "orderItems": [
      {
        "productId": 1,
        "quantity": 1
      }
    ]
  }'

"Create a customer named John Doe with email john.doe@example.com, phone +1-555-0123, and address at 123 Main St, New York, NY 10001, USA. Then add a MacBook Pro product priced at $2499.99 with SKU MBP-16-001 and 10 units in stock. Finally, create an order for John Doe with 1 MacBook Pro."

{
  "mcpServers": {
    "ecommerce-demo": {
      "command": "java",
      "args": ["-jar", "/path/to/ecommerce-mcp-demo.jar"],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}

npm install -g @modelcontextprotocol/cli

mcp connect http://localhost:8080/mcp

src/
├── main/
│   ├── java/com/example/ecommerce/
│   │   ├── controller/          # REST controllers
│   │   ├── dto/                 # Data transfer objects
│   │   ├── entity/              # JPA entities
│   │   ├── mcp/                 # MCP server implementation
│   │   ├── repository/          # Data repositories
│   │   ├── service/             # Business logic
│   │   └── config/              # Configuration classes
│   └── resources/
│       └── application.yml      # Application configuration
├── test/                        # Test files
└── build.gradle                 # Build configuration

@McpTool(
    name = "new_tool",
    description = "Description of what this tool does"
)
public Map<String, Object> newTool(
        @McpTool.Parameter(description = "Parameter description") String param) {
    // Implementation
    return Map.of("success", true, "data", result);
}

logging:
  level:
    com.example.ecommerce: DEBUG
    org.springframework.ai: DEBUG