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 测试客户端

项目包含一个测试客户端（ClientSTDIO），用于演示如何连接到 MCP 服务。

为什么 ClientSTDIO 需要访问服务 JAR

ClientSTDIO 类使用 Model Context Protocol（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 插件，确保类路径中包含所有依赖项：

# 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 文件的绝对路径。