Bitcoin MCP Server

Bitcoin MCP サーバー

このプロジェクトは、Bitcoin の価格情報を提供する Model Context Protocol（MCP）サーバーです。

プロジェクトのビルド

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

mvn clean package

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

MCP サーバーの実行

サーバーは、application.yaml ファイルで指定されているとおり、標準入出力（STDIO）を使用して通信するように設定されています。

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

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

ClientSTDIO がサーバーの JAR を参照する必要がある理由

ClientSTDIO クラスは、MCP サーバーと通信するために Model Context Protocol（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 に JAR ファイルがあるか確認します。

クライアントの実行

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

# Make sure you're in the project root directory
cd /opt/mcp/server/bitcoinmcp

# Run the client using 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. 通貨に USD を指定して、getBitcoinProceByCurrency ツールを呼び出します。
4. 結果を表示します。
5. 接続を閉じます。

トラブルシューティング

「MCP server JAR file not found」のようなエラーが表示された場合は、次の点を確認してください。

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

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