AI导哈

铭文服务器

一个基于模型上下文协议（MCP）的服务器，使AI模型能够与Ordinals铭文交互，从交易中显示内容。

  • by Laz1mov
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 Laz1mov/mcp-inscription

使用说明

MCP刻字服务器

Documentation | Available Tools | MCP Docs | Ordinals Docs

概述

一种模型上下文协议（MCP）服务器，使AI模型能够与序数铭文交互，允许它们显示交易中的内容。

🎮 演示

鹅演示 视频

💼 目录

🔧 特性

  • 顺序检测：自动检测比特币交易并将其解析为序数，支持基于文本、图像、json等铭文格式。

🦆 鹅集成

Goose是Block的一个开源AI代理框架，支持通过模型上下文协议进行扩展。您可以将MCP铭文服务器集成为Goose扩展，以允许Goose与序数铭文进行交互。Goose支持MCP服务器的两种集成模式：作为本地进程运行服务器（STDIO）或通过服务器发送事件（SSE）作为远程服务连接到服务器。以下是这两种方法的说明：

使用STDIO（本地扩展）

此方法将MCP Inscription服务器作为Goose的子进程在本地运行，通过标准输入/输出进行通信。

  1. 克隆并构建MCP铭文库（如果您还没有）：

    git clone https://github.com/Laz1mov/mcp-inscription
cd mcp-inscription
npm install
npm run build

    请注意存储库的完整绝对路径，因为您在下一步中将需要它。

  2. 在Goose中添加新扩展名： 打开Goose的配置界面。您可以通过命令行运行 goose configure，或在Goose Desktop应用程序中访问 设置>扩展。从菜单中选择 “添加扩展名。” (使用扩展|鹅)

  3. 选择扩展类型–命令行扩展： 当系统提示输入扩展类型时，选择 命令行扩展 （在CLI菜单或UI中），以便Goose知道它应该启动本地命令(使用扩展|鹅)（与内置或远程扩展相反）。

  4. 输入分机详细信息： 为MCP Inscription服务器提供名称和命令：

    • 身份证件: mcp-inscription

    • 姓名： 您可以称之为“mcp题词”，或任何标识符（这将是您引用扩展名的方式）。

    • 命令： 指定构建的CLI脚本的完整路径。例如：

      node /absolute/path/to/mcp-inscription/build/cli.js

      替换 /absolute/path/to/mcp-inscription 带有克隆存储库的实际路径。

    • 您通常不需要在脚本路径之外添加任何参数（除非您的服务器需要特殊标志）。

  5. 完成并启用： 完成扩展添加。Goose将在其配置中添加此新扩展（通常 ~/.config/goose/config.yaml).确保扩展 启用 （如果使用CLI向导，则添加后应默认启用它；在Goose Desktop应用程序中，您可以检查扩展列表，如果尚未打开，则可以将其打开(使用扩展|鹅) (使用扩展|鹅)).

  6. 使用新扩展启动Goose会话： 现在，您可以在Goose中使用该扩展。如果您通过CLI运行Goose，请运行以下命令启动包含扩展的会话：

    goose session --with-extension "mcp-inscription"

将“ordinals”替换为您为扩展名指定的任何名称(使用扩展|鹅).（这可确保会话加载扩展。或者，如果扩展是全局启用的，Goose Desktop或CLI将自动使其在所有会话中可用。）

使用SSE（远程扩展）

此方法通过HTTP SSE流将Goose连接到已运行的MCP服务器。如果您想将MCP Inscription服务器作为独立服务运行（可能在另一台机器上或仅独立于Goose），请使用此选项。

  1. 将MCP服务器作为独立服务启动： 在SSE模式下运行MCP Inscription服务器以监听连接：

    # Navigate to your mcp-inscription directory
cd /path/to/mcp-inscription

# If you havent built it yet
npm install
npm run build

# Run in SSE mode on port 3000 (default)
SERVER_MODE=sse node build/cli.js

# Alternatively, specify a different port
SERVER_MODE=sse PORT=9000 node build/cli.js

    这将以SSE模式启动服务器，使其在 http://localhost:3000 （或您指定的端口）。

  2. 在Goose（Remote）中添加新扩展名： 像以前一样，跑 goose configure 或使用Goose UI 添加扩展名 (使用扩展|鹅).这一次，选择 远程扩展 当被问及扩展类型时(使用扩展|鹅).这个消息告诉Goose它将通过SSE连接到外部服务器。

  3. 输入远程扩展详细信息： 为扩展名命名（例如“ordinals”）并提供服务器的URL 统一资源定位符，输入运行MCP服务器的基址。例如，如果您的服务器正在侦听本地计算机上的端口9000，您可以输入 http://localhost:9000.Gose将尝试连接到该地址的MCP服务器的SSE端点。（Goose使用标准MCP SSE路径，按照惯例，该路径位于 /mcp/sse 在服务器上路由时，通常只需要提供主机和端口，其余的由Goose处理。）

  4. 启用扩展： 添加远程扩展后，确保在Goose的设置中启用它（就像STDIO的情况一样）。只需要启用STDIO或SSE扩展中的一个（使用相同的工具）——如果您意外启用了同一服务器的本地和远程版本，您可能需要禁用一个以避免混淆。

在Goose中使用MCP铭文扩展： 一旦设置并启用了扩展（通过上述任一方法），您就可以与Goose交互并通过它查询ord数据。在新的Goose聊天或会话中，只需像往常一样提问。Goose将识别何时使用MCP铭文工具来满足您的请求。例如：

  • “显示序号：0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389？”

当你问这些问题时，Goose将调用MCP Inscription服务器的工具并返回答案（例如，最新的比特币区块信息）。您应该看到Goose通过MCP Inscription服务器从比特币区块链中获取最新信息。

如果Goose似乎没有使用该扩展（例如，如果它响应说找不到信息），请确保该扩展已启用，并且服务器正在运行（远程为SSE模式）。您还可以运行Goose的CLI，并记录详细日志，以查看它是否尝试调用扩展。通常，如果配置正确，Goose会自动发现MCP Inscription服务器的功能，并在相关时使用它们。

更多资源： 有关Goose扩展和MCP的更多详细信息，请参阅Goose官方文档(使用扩展|鹅).这些文档包括一系列内置和社区扩展，并解释了MCP服务器如何集成到Goose中。您还可以在Goose文档和模型上下文协议文档中找到可用MCP服务器的目录和其他配置提示。如果你想探索更多的扩展或开发自己的扩展，这会有所帮助。

🔑 Claude桌面集成

要将MCP Inscription服务器与Claude Desktop（Anthropic的Claude桌面应用程序）一起使用，请执行以下步骤：

  1. 下载并安装Claude Desktop： 访问Claude Desktop官方下载页面，获取适用于您的操作系统（macOS或Windows）的应用程序(安装桌面版Claude | Anthropic帮助中心).安装应用程序并确保您使用的是最新版本（您可以在应用程序菜单中检查更新）。

  2. 克隆并构建MCP铭文库：

    git clone https://github.com/Laz1mov/mcp-inscription
cd mcp-inscription
npm install
npm run build

  3. 配置Claude Desktop以使用MCP铭文服务器： 打开Claude Desktop配置文件（首次在Claude Desktop中编辑设置时创建）：

    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %APPDATA%\Claude\claude_desktop_config.json
      在此JSON配置中，在下面添加MCP Inscription服务器的条目 "mcpServers" 部分。例如：
    {
  "mcpServers": {
    "mcp-inscription": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-inscription/build/cli.js"]
    }
  }
}

    在上述片段中， "mcp-inscription" 是服务器的标识符（您可以随意命名）。替换 /absolute/path/to/mcp-inscription 包含克隆存储库的实际完整路径。

  4. 重新启动克劳德桌面： 保存 claude_desktop_config.json 文件，然后 关闭并重新打开Claude Desktop。下次启动时，Claude将按配置自动启动MCP Inscription服务器。如果Claude Desktop正在运行，则需要重新启动它才能使更改生效。

测试Claude桌面集成

重新启动Claude Desktop后，您可以测试MCP Inscription服务器是否正常工作：

  • 验证响应： 克劳德应该返回一个详细的答案（例如铭文本身或符文信息），没有错误。如果您收到错误消息或没有有用的响应，则MCP服务器可能连接不正确。

  • 检查克劳德的日志（如果需要）： Claude Desktop提供的日志文件可以帮助调试MCP集成。如果工具没有响应，请检查以下中的日志文件：

    • macOS： ~/Library/Logs/Claude/
    • 窗户： %APPDATA%\Claude\logs\
      寻找 mcp.log 对于一般MCP连接消息，以及一个名为 mcp-server-mcp-inscription.log （或您使用的任何名称）用于MCP服务器的输出/错误。这些日志将显示服务器是否启动或是否存在任何错误（例如服务器中的错误路径或异常）。如果您看到错误，请根据需要修复配置或环境，然后重新启动Claude Desktop并再次测试。

通过Smithery安装

通过以下方式自动安装Claude Desktop的Inscription Server 史密瑟里:

npx -y @smithery/cli install @Laz1mov/mcp-inscription --client claude

📂 项目结构

mcp-inscription/
├── src/
│   ├── ordinals_client.ts      # Bitcoin ordinals and runestone utility functions
│   ├── servers/
│   │   ├── index.ts            # Server exports and factory functions
│   │   ├── sse.ts              # Server implementation using SSE transport
│   │   ├── stdio.ts            # Server implementation using STDIO transport
│   │   └── base.ts             # Base server implementation with shared functionality
│   ├── index.ts                # Main entry point
│   ├── cli.ts                  # CLI launcher
│   ├── mcp_inscription_types.ts # Shared types and schemas for the MCP-Inscription server
│   └── utils/
│       ├── logger.ts           # Logger setup
│       ├── cache.ts            # Caching implementation
│       ├── error_handlers.ts   # Error handling utilities
│       ├── json_utils.ts       # JSON processing utilities
│       ├── img_utils.ts        # Image processing and conversion utilities
│       └── version.ts          # Version information
├── .env.example                # Example environment configuration file
├── package.json
├── tsconfig.json
└── README.md

📦 可用工具

show_ordinals

说明：
从交易的见证数据中解码序数铭文数据。

输入架构：

{
  "txid": "string"
}

输入示例：

{
  "txid": "0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389"
}

输出：
返回解码的铭文内容，可以是文本、JSON、HTML或其他格式。

🚨 错误处理

服务器采用自定义错误类型来处理比特币操作和区块链查询。使用Pino记录详细的错误消息，并将其包含在客户端响应中，以便于调试。

🤝 贡献

欢迎投稿和功能请求！欢迎在GitHub上提交pull请求或开放问题。

📝 许可证

该项目根据 MIT许可证.

相关 MCP