项目简介

MCP Inscription Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为AI模型提供访问和展示比特币 Ordinals 铭文内容的能力。通过此服务器,AI模型可以查询和显示 Ordinals 铭文,从而实现与比特币区块链上数字内容的互动。

主要功能点

  • Ordinals 铭文检测: 自动检测和解析比特币交易中的 Ordinals 铭文数据,支持文本、图片、JSON等多种铭文格式。
  • 数据访问能力: 提供 'show_ordinals' 工具,允许AI模型通过交易ID查询和获取 Ordinals 铭文内容。
  • 集成 Goose AI Agent: 可以作为 Goose AI Agent 框架的扩展,通过 STDIO 或 SSE 模式集成。
  • 集成 Claude Desktop: 支持与 Claude Desktop 应用集成,允许 Claude 与 Ordinals 铭文互动。
  • 支持多种传输协议: 支持 STDIO 和 SSE 两种服务器模式,满足不同客户端的连接需求。

安装步骤

  1. 克隆仓库
    git clone https://github.com/Laz1mov/mcp-inscription
    cd mcp-inscription
  2. 安装依赖并构建项目
    npm install
    npm run build

服务器配置

MCP客户端 (如 Goose, Claude Desktop) 配置信息 (JSON):

Goose 配置 (Command-Line Extension - STDIO 模式):

{
  "id": "mcp-inscription",
  "name": "mcp-inscription",
  "type": "command",
  "enabled": true,
  "configuration": {
    "command": "node",
    "args": [
      "/absolute/path/to/mcp-inscription/build/cli.js"  // 替换为 mcp-inscription 仓库 build/cli.js 文件的绝对路径
    ]
  }
}

Claude Desktop 配置 (编辑 'claude_desktop_config.json'):

{
  "mcpServers": {
    "mcp-inscription": {  // 服务器名称,可自定义
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-inscription/build/cli.js"  // 替换为 mcp-inscription 仓库 build/cli.js 文件的绝对路径
      ]
    }
  }
}

注意:

  • '/absolute/path/to/mcp-inscription' 需要替换为您本地 'mcp-inscription' 仓库的绝对路径。
  • Goose 和 Claude Desktop 需要配置 MCP 服务器的启动命令 (command) 及其参数 (args) 才能连接到 MCP 服务器。
  • 以上 JSON 配置信息请复制粘贴到 MCP 客户端的相应配置文件中。

基本使用方法

配置完成后,在 MCP 客户端 (如 Goose, Claude Desktop) 中,您可以向AI模型提出关于 Ordinals 铭文的问题,例如:

  • "显示 Ordinals 铭文: 0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389?"
  • "Ordinals 交易 0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389 的内容是什么?"

AI模型将调用 'show_ordinals' 工具,MCP Inscription Server 会解析交易数据并返回铭文内容。如果铭文是图片,服务器会将图片保存到本地缓存目录,并返回图片本地路径,以便AI模型展示或进一步分析。

服务器启动 (可选):

如果使用 SSE 模式,可以手动启动服务器:

cd mcp-inscription
SERVER_MODE=sse node build/cli.js

然后在 Goose 或 Claude Desktop 中配置 Remote Extension 并填写服务器 URL (例如: 'http://localhost:3000')。 注意: 通常情况下,使用 STDIO 模式,MCP 客户端会自动启动和管理 MCP Inscription Server,无需手动启动。

信息

分类

AI与计算