这是一个基于 Model Context Protocol (MCP) 的服务器实现，用于集成 opreturnbot.com 服务，允许 LLM 客户端方便地利用比特币的 OP_RETURN 特性将少量数据锚定到区块链上。

项目简介

该服务器充当 LLM 客户端与 opreturnbot.com 之间的桥梁。它遵循 MCP 规范，提供工具调用、Prompt 获取和资源列表等功能，使 LLM 能够通过标准化的协议与外部比特币服务交互。

主要功能点

• 比特币链上消息嵌入工具: 提供一个名为 'create_op_return' 的工具。LLM 可以调用此工具，提供一个文本消息作为参数。服务器会将请求发送到 opreturnbot.com API，该服务会生成一个闪电网络发票。当此发票支付后，opreturnbot.com 将创建一个包含该消息的比特币交易，并将其广播到网络中。
• Prompt 模板提供: 定义并提供 Prompt 模板，帮助 LLM 理解如何构造请求以调用特定的链上消息操作。
• 资源列表: 提供服务器可访问的资源列表（例如日志文件），尽管在当前实现中可能仅是示例资源。
• 标准 MCP 通信: 支持通过标准输入输出（Stdio）进行 JSON-RPC 通信，遵循 MCP 协议规范。

安装步骤

1. 确保安装 Rust 和 Cargo: 如果未安装，请访问 https://rustup.rs/ 进行安装。
2. 克隆仓库: 打开终端，执行以下命令克隆项目仓库：

   git clone https://github.com/benthecarman/mcp-op-return.git
   

3. 进入项目目录:

   cd mcp-op-return
   

4. 安装服务器: 使用 cargo 安装项目为可执行文件：

   cargo install --path .
   

   确保 Cargo 的 bin 目录已添加到系统的 PATH 环境变量中，以便能够直接运行 'mcp-op-return' 命令。

服务器配置

此 MCP 服务器主要通过 MCP 客户端进行配置和管理。LLM 客户端或其运行环境需要配置此 MCP 服务器的启动信息。

通常，这涉及在 MCP 客户端的配置文件（常见格式为 JSON）中添加一个条目，指定服务器的名称、启动命令和参数。

例如，配置中会包含类似以下信息：

• 服务器名称: 一个标识该服务器的唯一名称（如 'mcp-op-return'）。
• 命令 (command): 服务器可执行文件的路径（安装后通常是 'mcp-op-return'）。
• 参数 (args): 启动服务器时需要传递的参数。为了以 MCP 模式运行，必须包含 '--mcp' 参数。例如，参数列表可以是 '["--mcp"]'。

LLM 客户端在启动时会读取此配置，并按照指定的命令和参数启动服务器，然后通过标准输入/输出建立 MCP 连接。

基本使用方法

该服务器通常作为后台服务由 MCP 客户端启动和管理，用户不需要直接通过命令行与其交互（除非是用于列表查询功能，但不常见）。

1. 由 MCP 客户端启动: 按照 MCP 客户端的说明，确保上述服务器配置已添加到客户端的配置中。启动 MCP 客户端后，它会自动检测配置的服务器并尝试启动 'mcp-op-return --mcp' 命令。
2. LLM 调用工具: 一旦连接建立，兼容的 LLM 客户端就可以通过 MCP 协议调用服务器提供的工具。例如，LLM 可以识别用户意图，构造一个 MCP 请求来调用 'create_op_return' 工具，并传递用户想要嵌入的消息作为 'message' 参数。
3. 服务器处理请求: 服务器接收到 MCP 请求后，会执行相应的处理逻辑（如调用 opreturnbot.com API），并将结果通过 MCP 响应返回给客户端。

简而言之，用户通过与 LLM 客户端交互来间接使用此 MCP 服务器提供的比特币链上消息嵌入功能。