Spring Bitcoin MCP Server

🚀 Bitcoin MCP サーバー

このプロジェクトは、ビットコインの価格情報を提供するモデルコンテキストプロトコル（MCP）サーバーを提供します。

🚀 クイックスタート

📦 インストール

プロジェクトのビルド

プロジェクトをビルドするには、以下のコマンドを実行します。

mvn clean package

これにより、target/bitcoinmcp-0.0.1-SNAPSHOT.jar の場所に JAR ファイルが作成されます。

💻 使用例

MCP サーバーの実行

サーバーは標準入出力（STDIO）を使用して通信するように構成されており、詳細な情報は application.yaml ファイルで確認できます。

ClientSTDIO テストクライアントの使用

このプロジェクトには、MCP サーバーに接続する方法を示すテストクライアント (ClientSTDIO) が含まれています。

ClientSTDIO がサーバー JAR ファイルを参照する理由

ClientSTDIO クラスは、モデルコンテキストプロトコル（MCP）クライアントライブラリを使用して MCP サーバーと通信します。サーバー JAR ファイルを参照する必要がある理由は以下の通りです。

1. MCP クライアントはサブプロセスメカニズムを使用してサーバーを起動します。
2. サーバーは JAR ファイルを個別の Java プロセスとして実行することで起動されます。
3. クライアントとサーバーは標準入出力（STDIO）を介して通信します。

このアーキテクチャにより、クライアントはサーバーを手動で起動したり、ネットワークポートを公開したりすることなく、サーバーとやり取りすることができます。ただし、クライアントはサーバー JAR ファイルの場所を知る必要があります。

JAR ファイルパスの設定

クライアントは JAR ファイルの場所を知る必要があります。指定する方法は以下の 3 つがあります。

1. システムプロパティ：

java -Dmcp.server.jar.path=/path/to/bitcoinmcp-0.0.1-SNAPSHOT.jar -cp target/test-classes za.sk.bitconmcp.ClientSTDIO

2. 環境変数：

export MCP_SERVER_JAR_PATH=/path/to/bitcoinmcp-0.0.1-SNAPSHOT.jar
java -cp target/test-classes za.sk.bitconmcp.ClientSTDIO

3. デフォルトパス： システムプロパティまたは環境変数が設定されていない場合、クライアントは現在の作業ディレクトリから相対的な target/bitcoinmcp-0.0.1-SNAPSHOT.jar の場所を探します。

クライアントの実行

クライアントを実行するには、すべての依存関係がクラスパスに含まれるように、Maven の exec プラグインを使用します。

# プロジェクトのルートディレクトリにいることを確認
cd /opt/mcp/server/bitcoinmcp

# Maven を使用してクライアントを実行
mvn exec:java -Dexec.classpathScope=test -Dexec.mainClass="za.sk.bitconmcp.ClientSTDIO"

また、JAR ファイルの絶対パスを指定することもできます。

mvn exec:java -Dexec.classpathScope=test -Dexec.mainClass="za.sk.bitconmcp.ClientSTDIO" -Dmcp.server.jar.path=/path/to/bitcoinmcp-0.0.1-SNAPSHOT.jar

クライアントは以下の処理を行います。

1. MCP サーバーに接続します。
2. 利用可能なツールを一覧表示します。
3. getBitcoinProceByCurrency ツールを呼び出し、通貨として USD を使用します。
4. 結果を表示します。
5. 接続を閉じます。

🔧 トラブルシューティング

「MCP サーバー JAR ファイルが見つかりません」というエラーが表示された場合は、以下のことを確認してください。

1. mvn clean package を使用してプロジェクトをビルドしていること。
2. クライアントを正しいディレクトリから実行していること。
3. JAR ファイルのパスが正しく設定されていること。

また、上記の設定方法のいずれかを使用して、JAR ファイルの絶対パスを指定することもできます。