Small Business Customer Care

🏪 小規模事業者向けカスタマーケア MCP サーバー

Claude Desktop などの AI アシスタントを通じて、小規模事業者のカスタマーケア業務を管理する、Spring AI を活用した MCP（Model Context Protocol）サーバーです。

🌟 MCP.so で特集されました - コミュニティで、さらに多くの MCP サーバーを見つけましょう！

💬 動作例

この MCP サーバーを使うと、Claude Desktop との自然な会話を通じて、次のような操作ができます。

👤 ユーザー	🤖 Claude（MCP 経由）	🔧 実行内容
「事業者の一覧を表示して」	5 件すべての事業者について、詳細とカテゴリを一覧表示	list_businesses ツールを使用
「Green Thumb の事業者を削除して」	✅ 「削除しました：Green Thumb Landscaping 事業者」	ID「3」を指定して remove_business を使用
「午前 9 時に開店し、午後 5 時に閉店する Ravi Restaurant という事業者を新規作成して」	✅ 「作成しました：Ravi Restaurant • カテゴリ：レストラン • 営業時間：毎日午前 9:00～午後 5:00 • 所在地：789 Pine Rd, Springfield」	説明に営業時間を含めて create_business を使用
「Mike's Auto Repair は午後 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 の詳細を表示	クエリ「restaurant」で search_businesses を使用

🎯 その力：自然言語 → 構造化された事業者業務 → 実データの管理

⚡ 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/...

Step 4: Claude Desktop を再起動する

設定を更新した後、Claude Desktop を完全に終了してから再度開いてください：

• macOS：Cmd+Q で終了し、Applications から再度開きます
• Windows：システムトレイのアイコンを右クリックして「終了」を選択し、再度開きます
• 別の方法：Claude Desktop のウィンドウをすべて閉じ、アプリケーションを再度開きます

macOS では Cmd+Q を使って Claude Desktop を終了します

MCP サーバーが利用可能になります。

Step 5: 接続を確認する

1. 開発者設定を確認する：Claude Desktop の「設定」→「開発者」タブに移動し、MCP サーバーが実行中であることを確認します

Claude Desktop の開発者設定で MCP サーバーが正常に実行されている状態

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 Framework で構築されています：

• 堅牢な MCP プロトコル処理に spring-ai-mcp-server-spring-boot-starter を使用
• @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 を活用したビジネスデータの管理を始めましょう！ 🚀