Small Business Customer Care

🏪 小型企业客户服务 MCP 服务

一个由 Spring AI 驱动的 MCP（模型上下文协议）服务，可通过 Claude Desktop 等 AI 助手管理小型企业的客户服务运营。

🌟 MCP.so 精选项目 - 探索社区中的更多 MCP 服务！

💬 实际效果

通过与 Claude Desktop 自然对话，你可以使用此 MCP 服务完成以下操作：

👤 用户	🤖 Claude（通过 MCP）	🔧 操作说明
“显示企业列表”	列出全部 5 家企业及其详情和类别	使用了 list_businesses 工具
“删除 green thumb 企业”	✅ “已删除：Green Thumb Landscaping 企业”	使用 remove_business，ID 为 "3"
“创建一家名为 Ravi Restaurant、上午 9 点营业、下午 5 点打烊的新企业”	✅ “已创建：Ravi Restaurant • 类别：餐厅 • 营业时间：每天上午 9:00 - 下午 5:00 • 地址：789 Pine Rd, Springfield”	使用 create_business，并在描述中添加营业时间
“Mike's 汽车维修店下午 1 点营业，晚上 9 点打烊”	✅ “已更新：Mike's Auto Repair • 营业时间：每天下午 1:00 - 晚上 9:00 • 其他详情均予以保留”	使用 update_business 添加营业时间
“显示企业名称列表”	当前企业： • Joe's Coffee Shop • Tech Repair Solutions • Bella's Boutique • Mike's Auto Repair（营业时间：下午 1:00 - 晚上 9:00） • Ravi Restaurant（营业时间：上午 9:00 - 下午 5:00） 总计：5 家企业	使用了 list_businesses 并整理了回复
“查找所有餐厅”	显示 Ravi Restaurant 和 Joe's Coffee Shop 的完整详情	使用 search_businesses，查询词为 "restaurant"

🎯 核心优势：自然语言 → 结构化企业操作 → 实际数据管理

⚡ Claude Desktop 设置

第 1 步：下载 Claude Desktop

从官方网站下载并安装 Claude Desktop：

• 官方下载：https://claude.ai/download
• 适用于 macOS、Windows 和 Linux

从官方网站下载 Claude Desktop

第 2 步：构建 MCP 服务

# Clone and build the project
git clone https://github.com/ravikalla/mcp-small-business-customer-care.git
cd mcp-small-business-customer-care
mvn clean package

# Verify JAR creation
ls -la target/small-business-customer-care-1.0.0.jar

第 3 步：配置 Claude Desktop

打开 Claude Desktop 配置文件：

📍 配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

💡 提示：在 macOS 上，可以快速打开配置文件：

open "~/Library/Application Support/Claude/claude_desktop_config.json"

添加以下配置：

{
  "mcpServers": {
    "small-business-customer-care": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/your/mcp-small-business-customer-care/target/small-business-customer-care-1.0.0.jar"
      ],
      "env": {}
    }
  }
}

MCP 服务条目的配置文件示例

⚠️ 重要说明：

• 将 /absolute/path/to/your/ 替换为实际的项目路径
• 仅使用绝对路径（例如：/Users/john/projects/mcp-small-business-customer-care/target/...）
• 在 Windows 上，请使用正斜杠：C:/Users/john/projects/...

第 4 步：重启 Claude Desktop

更新配置后，完全退出并重新打开 Claude Desktop：

• macOS：按 Cmd+Q 退出，然后从“应用程序”中重新打开
• Windows：右键单击系统托盘图标 → 退出，然后重新打开
• 替代方法：关闭所有 Claude Desktop 窗口，然后重新打开应用程序

在 macOS 上按 Cmd+Q 退出 Claude Desktop

现在应该可以使用 MCP 服务了。

第 5 步：验证连接

1. 检查开发者设置：前往 Claude Desktop 设置 → Developer 标签页，查看 MCP 服务是否正在运行

MCP 服务在 Claude Desktop 的开发者设置中成功运行

2. 测试工具：尝试询问：
   • “显示所有商家”
   • “有哪些商家管理工具可用？”

你应该会看到商家管理工具正常运行！🎉

展示 MCP 工具实际运行情况的对话示例

📚 其他资源：

• MCP.so 社区平台 - 我们的服务列表
• Claude Desktop MCP 文档
• MCP 故障排除指南
• Spring AI MCP 文档

🚀 快速开始

前提条件

• Java 17 或更高版本
• Maven 3.6 或更高版本
• Claude Desktop（用于集成 AI 助手）

安装与构建

# Clone the repository
git clone https://github.com/ravikalla/mcp-small-business-customer-care.git
cd mcp-small-business-customer-care

# Build the application
mvn clean package

# Verify the JAR was created
ls -la target/small-business-customer-care-1.0.0.jar

测试服务

# Test initialization
echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05"},"id":0}' | java -jar target/small-business-customer-care-1.0.0.jar

# Test business listing
echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list_businesses","arguments":{}},"id":2}' | java -jar target/small-business-customer-care-1.0.0.jar

🔧 Claude Desktop 集成

将此配置添加到 Claude Desktop 配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "small-business-customer-care": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/your/mcp-small-business-customer-care/target/small-business-customer-care-1.0.0.jar"
      ],
      "env": {}
    }
  }
}

重要提示：将 /path/to/your/ 替换为项目目录的实际绝对路径。

更新配置后，完全重启 Claude Desktop。

🛠️ 可用的商家工具

该服务提供 6 个 MCP 工具，用于全面的商家管理：

工具	用途	使用示例
list_businesses	获取所有商家	“显示所有商家”
search_businesses	按名称/类别/描述查找	“查找餐厅”
get_business	按 ID 获取详情	“显示商家 1 的详情”
create_business	添加新商家	“创建 Ravi Restaurant...”
update_business	修改现有商家	“更新营业时间...”
remove_business	删除商家	“删除 Green Thumb 商家”

JSON API 示例

// Create new business
{
  "method": "tools/call",
  "params": {
    "name": "create_business",
    "arguments": {
      "name": "Ravi Restaurant",
      "category": "Restaurant", 
      "address": "789 Pine Rd, Springfield",
      "phone": "555-0106",
      "email": "[email protected]",
      "description": "Family-friendly restaurant. Hours: 9:00 AM - 5:00 PM daily",
      "rating": 4.5
    }
  }
}

// Search businesses
{
  "method": "tools/call",
  "params": {
    "name": "search_businesses",
    "arguments": { "query": "restaurant" }
  }
}

🏗️ 技术架构

基于 Spring AI MCP 框架构建：

• 使用 spring-ai-mcp-server-spring-boot-starter，可靠地处理 MCP 协议
• 使用 @Tool 通过注解定义工具
• 通过 ToolCallbacks.from() 自动发现工具
• 使用配置完善的日志记录，实现简洁的 STDIO 传输

@Service
public class BusinessService {
    @Tool(name = "list_businesses", description = "Get a list of all businesses")
    public List<Business> listBusinesses() { ... }
    
    @Tool(name = "search_businesses", description = "Search businesses by name, category, or description")
    public List<Business> searchBusinesses(String query) { ... }
    // ... other tool methods
}

🧪 开发与测试

# Run all tests
mvn test

# Start in development mode  
mvn spring-boot:run

# Build for production
mvn clean package -DskipTests

示例数据：服务预先加载了 5 家商户： Joe's Coffee Shop、Tech Repair Solutions、Green Thumb Landscaping、Bella's Boutique、Mike's Auto Repair

🔧 故障排除

服务无法连接：

1. 验证 Java 17+：java -version
2. 检查 JAR 是否存在：ls -la target/small-business-customer-care-1.0.0.jar
3. 使用上方的 echo 命令手动测试
4. 完全重启 Claude Desktop

构建问题：

mvn clean package -DskipTests  # Skip tests if failing
mvn clean package -X          # Verbose output

路径问题：

• 在 Claude Desktop 配置中使用绝对路径
• 使用引号处理空格："/path with spaces/"

📚 资源

• Model Context Protocol 规范
• Spring AI 文档
• Claude Desktop MCP 配置

📄 许可证

本项目为开源项目，采用 MIT 许可证。

🌐 社区

此 MCP 服务是不断壮大的 MCP.so 社区 的一员！

• ⭐ 如果你觉得项目有用，请为项目点星
• 🐛 在 GitHub 上报告问题
• 💡 为未来版本提出功能建议
• 🤝 参与贡献，让项目变得更好

发现更多 MCP 服务：浏览 MCP.so 目录，查找适用于不同场景的其他优秀 MCP 服务。

---

准备好使用了吗？ 按照上方的 Claude Desktop 集成步骤操作，开始用 AI 管理业务数据吧！🚀