Spring Bitcoin MCP Server

🚀 Bitcoin MCP 服務器

本項目提供了一個用於比特幣價格信息的模型上下文協議（MCP）服務器，可幫助用戶獲取比特幣價格相關信息，為比特幣價格數據的處理提供了有效的解決方案。

🚀 快速開始

📦 安裝指南

要構建項目，請運行以下命令：

mvn clean package

這將在 target/bitcoinmcp-0.0.1-SNAPSHOT.jar 處創建一個 JAR 文件。

💻 使用示例

運行 MCP 服務器

服務器配置為使用標準輸入輸出（STDIO）進行通信，具體信息可在 application.yaml 文件中查看。

使用 ClientSTDIO 測試客戶端

該項目包含一個測試客戶端 (ClientSTDIO)，用於演示如何連接到 MCP 服務器。

為什麼 ClientSTDIO 需要看到服務器 JAR 文件

ClientSTDIO 類使用模型上下文協議（MCP）客戶庫來與 MCP 服務器通信。它需要引用服務器 JAR 文件，原因如下：

1. MCP 客戶端使用子進程機制啟動服務器。
2. 它通過執行 JAR 文件作為單獨的 Java 進程來啟動服務器。
3. 客戶端和服務器通過標準輸入輸出（STDIO）進行通信。

這種架構允許客戶端無需手動啟動服務器或暴露網絡端口即可與其交互。然而，它意味著客戶端需要知道服務器 JAR 文件的位置。

配置 JAR 文件路徑

客戶端需要知道 JAR 文件的位置，有三種方法可以指定：

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 插件以確保所有依賴項包含在類路徑中：

# 確保你在項目根目錄下
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 文件的絕對路徑。