MCP Small Business Customer Care

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

    

A. Spring AI驱动的MCP（模型上下文协议）服务器 通过Claude Desktop等人工智能助手管理小型企业客户服务运营。

🌟 MCP.so上的特色 -在社区中发现更多MCP服务器！

💬 在行动中看到它

通过与Claude Desktop的自然对话，您可以使用此MCP服务器执行以下操作：

•类别：餐厅 •营业时间：每天上午9:00至下午5:00 •位置：斯普林菲尔德松树路789号“|已使用 create_business 描述中有小时数| |“迈克的汽车修理店下午1点开门，晚上9点关门”|✅ 更新：迈克的汽车修理 •营业时间：每天下午1:00至9:00 •保留所有其他细节“|已使用 update_business 增加小时数| |“显示企业名称列表”| 当前业务： •乔咖啡店 •技术维修解决方案 •贝拉精品店 •迈克的汽车维修（时间：下午1:00-晚上9:00） •拉维餐厅（营业时间：上午9:00至下午5:00）

总计：5家企业 |已使用 list_businesses 以及格式化响应| |“查找所有餐厅”|显示拉维餐厅和乔咖啡店的全部细节|已使用 search_businesses 查询“餐厅”|

🎯 权力：自然语言→ 结构化业务运营→ 真实数据管理

⚡ Claude桌面设置

第一步：下载克劳德桌面

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

• 官方下载:
• 可用于 macOS, 视窗，以及 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桌面

打开Claude Desktop配置文件：

📍 配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %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：

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

*在macOS上使用Cmd+Q退出Claude Desktop*

MCP服务器现在应该可用。

步骤5：验证连接

1. 检查开发人员设置：转到克劳德桌面设置→ “开发人员”选项卡，查看MCP服务器的运行情况

*MCP服务器在Claude Desktop的开发人员设置中成功运行*

1. 测试工具：试着问：

- *“显示所有业务”* - *“有哪些可用的商业工具？”*

您应该看到业务管理工具正在工作！ 🎉

*显示MCP工具运行的示例对话*

📚 其他资源：

• MCP.so社区平台 -我们的服务器列表
• Claude桌面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桌面集成

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

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %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/ 使用项目目录的实际绝对路径。

重新启动克劳德桌面 在更新配置后完全完成。

🛠️ 可用的业务工具

服务器提供6个MCP工具，用于完整的业务管理：

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": "info@ravirestaurant.com",
      "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 listBusinesses() { ... }
    
    @Tool(name = "search_businesses", description = "Search businesses by name, category, or description")
    public List 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个业务： 乔的咖啡店，技术维修解决方案，绿拇指景观，贝拉的精品店，迈克的汽车维修

🔧 故障排除

服务器未连接：

1. 验证Java 17+： java -version
2. 检查JAR是否存在： ls -la target/small-business-customer-care-1.0.0.jar
3. 使用上述回声命令手动测试
4. 完全重新启动克劳德桌面

构建问题：

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

路径问题：

• 在Claude Desktop配置中使用绝对路径
• 带引号的转义空格： "/path with spaces/"

📚 资源

• 模型上下文协议规范
• Spring AI文档
• Claude桌面MCP设置

📄 许可证

这个项目是开源的，可以在MIT许可证下使用。

🌐 社区

此MCP服务器是不断增长的 MCP.so社区!

• ⭐ 明星项目 如果你觉得它有用
• 🐛 报告问题 在GitHub上
• 💡 建议功能 对于未来的版本
• 🤝 贡献 让它变得更好

发现更多MCP服务器：浏览 MCP.so目录 为不同的用例找到其他令人惊叹的MCP服务器。

______________________________________________________________________

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