MCP Craftgate Projesi

MCP Craftgate プロジェクト

プロジェクトについて

このプロジェクトは、Craftgate 決済インフラと連携する MCP（Model Context Protocol）サーバーです。つまり、決済の照会、レポート作成、管理を行うためのインターフェースを提供します。Spring Boot で開発されており、Craftgate API に接続して決済データを処理します。

簡単に言うと：

• Craftgate を通じて行われた決済の照会やレポート作成に使用します。
• サーバーとして動作し、外部からのリクエストを処理します。
• MCP プロトコルに準拠しています。

プロジェクト構成

• src/main/java/：Java のソースコードが格納されています。
• src/main/resources/application.properties：設定ファイル（API キーをここに保存します）。
• build.gradle：プロジェクトの依存関係とビルド設定です。
• build/libs/：ビルドされた JAR ファイルがここに生成されます。

必要条件

• Java 17 以降
• Gradle（またはプロジェクトに含まれる gradlew スクリプト）
• インターネット接続（依存関係をダウンロードするため）

インストールと実行の手順

1. ソースコードをダウンロードする

プロジェクトをフォルダーにクローンするか、ダウンロードします。

2. API キーを設定する

src/main/resources/application.properties ファイルに、次の行があります：

craftgate.api-key=dummy-api-key
craftgate.secret-key=dummy-secret-key
craftgate.base-url=https://sandbox-api.craftgate.io

実際のキーを使用する場合は、dummy-api-key と dummy-secret-key を自分の Craftgate API キーに置き換えてください。（テストではダミー値のままでもかまいません。）

3. JAR ファイルを作成する

ターミナルを開き、プロジェクトフォルダーに移動します。次に、以下のコマンドを実行します：

./gradlew clean build

• Windows を使用している場合：gradlew.bat clean build
• このコマンドにより、プロジェクトがビルドされ、実行可能な JAR ファイルが作成されます。

生成された JAR ファイルは、次のフォルダーにあります：

build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar

4. JAR ファイルを実行する

ターミナルで、次のコマンドを使用できます：

java -jar build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar

このコマンドで、MCP Craftgate サーバーが起動します。

5. MCP 設定ファイルの設定方法

MCP 環境でこの JAR ファイルを使用するには、設定ファイルを以下のように設定します。特に command と args の項目に注意してください：

"craftgate-mcp": {
  "command": "java",
  "args": [
    "-Dspring.ai.mcp.server.stdio=true",
    "-jar",
    "/tam/yol/build/libs/mcp_craftgate-0.0.1-SNAPSHOT.jar"
  ]
}

• command：実行するメインコマンド（ここでは java）。
• args：コマンドに渡す引数。
  • -Dspring.ai.mcp.server.stdio=true パラメーターは、MCP と互換性のある動作に必要です。
  • -jar の後に、JAR ファイルの絶対パスを指定します。
• /tam/yol/ の部分は、自分のコンピューター上の実際のディレクトリーに置き換えてください。

MCP 環境では、この設定を使用すると Craftgate ツールが自動的に起動し、使用できるようになります。

6. サーバーが動作していることを確認する

サーバーの起動後、ログにエラーがなく、ポートの競合も発生していなければ、MCP 環境でこのツールを使用できます。

---

よくある質問

Q：API キーはどこで入手できますか？
A：Craftgate のパネル、または管理者から入手できます。

Q：JAR ファイルを別の場所に移動するとどうなりますか？
A：MCP 設定ファイル内の JAR ファイルのパスを、新しい場所に合わせて更新してください。

Q：依存関係は自動でダウンロードされますか？
A：はい。Gradle は初回のビルド時にすべての依存関係を自動的にダウンロードします。

---

補足情報

• このプロジェクトは Spring Boot で開発されているため、一般的な Java アプリケーションと同様に動作します。
• テストには ./gradlew test コマンドを使用できます。
• ログは model-context-protocol/craftgate/starter-stdio-server/target/mcp-craftgate-stdio-server.log ファイルに書き込まれます。

---

すべての手順に従えば、プロジェクトの JAR ファイルを作成し、MCP 環境で使用できます。行き詰まった場合は、手順をもう一度確認するか、サポートを依頼してください！