使用说明

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

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

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

💬 在行动中看到它

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

👤 用户	🤖 克劳德（通过MCP）	🔧 发生了什么
“显示企业列表”	列出所有5家企业及其详细信息和类别	已使用 `list_businesses` 工具
“删除绿拇指业务”	✅ “已删除：绿拇指园艺业务”	已使用 `remove_business` ID为“3”
“创建名为Ravi Restaurant的新业务，上午9点开门，下午5点关门”	✅ “创建：拉维餐厅 •类别：餐厅 •营业时间：每天上午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：

官方下载: https://claude.ai/download
可用于 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：验证连接

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

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

测试工具：试着问：
- “显示所有业务”
- “有哪些可用的商业工具？”

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

显示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工具，用于完整的业务管理：

工具	目的	示例用法
`list_businesses`	获取所有业务	“显示所有业务”
`search_businesses`	按名称/类别/描述查找	“查找餐厅”
`get_business`	按ID获取详细信息	“显示企业1的详细信息”
`create_business`	添加新业务	“创建拉维餐厅…”
`update_business`	修改现有业务	“更新…的营业时间”
`remove_business`	删除业务	“删除绿拇指业务”

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<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个业务：乔的咖啡店，技术维修解决方案，绿拇指景观，贝拉的精品店，迈克的汽车维修

🔧 故障排除

服务器未连接：

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

构建问题：

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

路径问题：

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

📚 资源

📄 许可证

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

🌐 社区

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

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

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