NextApp Payments MCP Server Demo

NextApp Payments MCP サーバーのデモ

MCP Inspector と Claude AI との連携を通じて、MongoDB の決済データを公開する Model Context Protocol（MCP）サーバーの実装方法を紹介するデモプロジェクトです。このプロジェクトでは、MCP プロトコルを使用して、標準化されたインターフェースを通じてデータベースのリソースを公開する方法を例として紹介します。

📝 この MCP サーバーをゼロから構築する手順を詳しく解説したガイドは、包括的なブログ記事をご覧ください。

プロジェクト概要

このデモプロジェクトでは、以下の内容を紹介します。

• 公式 SDK を使用した MCP サーバーの実装
• 特定の MongoDB Atlas データベースへの接続
• MCP リソースとツールの両方を通じた決済データの公開
• MCP Inspector と Claude AI の両方との連携
• LLM が構造化されたデータベースデータを操作する方法

機能

MCP リソース

• URI: payments://done
• 用途: done: true の決済レコードを取得します
• レスポンス形式: JSON
• MIME タイプ: application/json

MCP ツール

1. get_completed_payments

   • 説明：done が true のすべての決済を取得します
   • 入力：パラメーターは不要です
   • 出力：完了した決済の JSON 配列

2. get_all_payments

   • 説明：データベース内のすべての決済を取得します
   • 入力：パラメーターは不要です
   • 出力：すべての決済の JSON 配列

MCP Inspector の画面

上の画像は、MCP サーバーを通じて MongoDB Atlas から取得した決済レコードを表示する MCP Inspector のインターフェースです。MCP Inspector は、MCP サーバーの実装を検証およびデバッグするための開発者向けツールです。

Claude AI との連携

上の画像は、Claude AI が以下を正常に実行する様子を示しています。

• MCP サーバーへの接続
• 決済リソースとツールへのアクセス
• 決済データの分析
• 合計金額、日付範囲、重要な所見を含む構造化された結果の提示

Claude Desktop での MCP リソースの設定

独自の MCP サーバーを作成し、Claude Desktop で使用する場合は、次の手順を行ってください。

1. Claude Desktop の設定ファイルを探す

   • Windows：C:\Users\<username>\AppData\Roaming\claude\claude_desktop_config.json
   • macOS：~/Library/Application Support/claude/claude_desktop_config.json
   • Linux：~/.config/claude/claude_desktop_config.json

2. MCP サーバーを設定する

   {
     "mcpServers": {
       "YourServerName": {
         "transport": "stdio",
         "command": "node",
         "args": ["path/to/your/server.js"],
         "env": {
           "YOUR_ENV_VARIABLE": "your_value"
         },
         "cwd": "path/to/your/project"
       }
     }
   }
   

   次の項目を置き換えてください。

   • YourServerName：サーバーの一意な名前
   • path/to/your/server.js：サーバーファイルのフルパス
   • YOUR_ENV_VARIABLE：サーバーに必要な環境変数

3. 接続を確認する

   • Claude Desktop を開きます
   • ［Settings］→［Developer］に移動します
   • サーバーに「running」ステータスが表示されていることを確認します

4. リソースまたはツールを使用する

   # Using Resource
   Use the MCP resource payments://done and [your query]
   
   # Using Tools
   Use the MCP tool get_completed_payments to show me all successful payments
   Use the MCP tool get_all_payments to show me all payments in the system
   

実装の詳細

使用技術

• MCP SDK：プロトコルの処理とリソース／ツールの公開に使用
• MongoDB Driver：データベースへのアクセスとクエリの実行に使用
• Claude Desktop：LLM との連携と自然言語によるクエリに使用

エラー処理

この実装には、以下に対するエラー処理が含まれています。

• MongoDB の接続問題
• クエリの実行エラー
• 接続の終了エラー
• Claude Desktop との互換性を確保する JSON 形式のログ出力

重要な注意事項

このデモプロジェクトでは、以下の内容を紹介します。

1. MCP サーバーの実装方法
2. MongoDB データを MCP リソースとツールの両方として公開する方法
3. データにアクセスする複数の方法：
   • MCP Inspector を通じたアクセス（開発者向け）
   • Claude AI を通じたアクセス（エンドユーザー向け）
   • ツールの直接呼び出し
4. LLM が構造化データを操作する方法

MongoDB の接続設定とリソース設定は、このデモ専用です。ご自身の用途に合わせて変更する必要があります。

リソース

• Model Context Protocol のドキュメント
• Claude Desktop のドキュメント
• MongoDB Node.js Driver のドキュメント