使用说明

项目简介

ordiscan-mcp 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型（LLM）应用提供访问比特币 Ordinals 和 Runes 相关信息的能力。它通过工具化的方式，让 LLM 能够查询和利用 Ordiscan 平台上的数据，从而增强 LLM 在比特币生态领域的应用场景。

主要功能点

铭文 (Inscriptions) 信息查询: 支持查询铭文列表、铭文详情、铭文特征等信息。
符文 (Runes) 信息查询: 支持查询符文列表、符文详情、符文市场信息、符文解锁日期等信息。
比特币地址信息查询: 支持查询地址拥有的铭文 ID、符文余额、BRC-20 余额、稀有聪 (Rare Sats) 余额等信息。
交易 (Transaction) 信息查询: 支持查询交易中的铭文和符文信息。
集合 (Collection) 信息查询: 支持查询 Ordinals 集合的信息。
生成铭刻 (Inscribe) 链接: 为用户生成用于铭刻内容的链接。
生成 Mint 符文链接: 为用户生成用于 Mint 特定符文的链接。

所有工具均以 JSON-RPC 格式通过标准 MCP 协议与客户端通信，方便集成到各种支持 MCP 协议的 LLM 应用中。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
安装依赖: 在项目根目录下，打开终端并运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令构建服务器代码：
```
npm run build
```

服务器配置

要将 Ordiscan MCP 服务器与 MCP 客户端（例如 Claude Desktop）集成，你需要配置客户端以连接到该服务器。以下是 Claude Desktop 的配置示例，你需要将配置信息添加到 'claude_desktop_config.json' 文件中。

配置文件路径:

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置信息 (JSON 格式):

{
  "mcpServers": {
    "ordiscan": {  //  服务器名称，可以自定义
      "command": "npx", // 启动服务器的命令，这里使用 npx 执行 npm 包
      "args": [
        "ordiscan-mcp@latest" //  服务器 npm 包名称，@latest 表示使用最新版本
      ],
      "env": {
        "ORDISCAN_API_KEY": "YOUR_API_KEY" //  Ordiscan API 密钥，你需要替换为你的 API 密钥
      }
    }
  }
}

请务必将 'YOUR_API_KEY' 替换为你从 Ordiscan 官网（https://ordiscan.com/docs/api）获取的 API 密钥。 Ordiscan API 密钥是免费获取的。

基本使用方法

配置完成后，当你在支持 MCP 协议的 LLM 客户端中使用时，客户端将能够发现并调用 'ordiscan-mcp' 服务器提供的工具。

例如，在 Claude Desktop 中，你可以指示 Claude 使用 'rune_market_info' 工具查询某个 Rune 的市场信息，或者使用 'inscription_info' 工具查询某个铭文的详细信息。 LLM 将根据工具的描述和输入参数来调用相应的工具，并将结果返回给你。

示例使用场景:

让 LLM 客户端查询最新的 Rune 价格。
让 LLM 客户端获取特定比特币地址的铭文列表。
让 LLM 客户端生成一个用于铭刻文本内容的链接。

关键词