](https://mseep.ai/app/laz1mov-mcp-inscription)
MCP刻字服务器
](https://smithery.ai/server/@Laz1mov/mcp-inscription)
Documentation
|
Available Tools
|
MCP Docs
|
Ordinals Docs
概述
一种模型上下文协议（MCP）服务器，使AI模型能够与序数铭文交互，允许它们显示交易中的内容。
🎮 演示
|鹅演示 视频 | | --------------------------------------------------------------------------------------------------- | |
|
💼 目录
- 概述 - 💼 目录 - 🔧 特性 - 🦆 鹅集成 - 使用STDIO（本地扩展） - 使用SSE（远程扩展） - 🔑 Claude桌面集成 - 测试Claude桌面集成 - 📂 项目结构 - 📦 开发设置 - 📦 可用工具 - show_ordinals - 🚨 错误处理 - 🤝 贡献 - 📝 许可证
🔧 特性
- 顺序检测：自动检测比特币交易并将其解析为序数，支持基于文本、图像、json等铭文格式。
🦆 鹅集成
Goose是Block的一个开源AI代理框架，支持通过模型上下文协议进行扩展。您可以将MCP铭文服务器集成为Goose扩展，以允许Goose与序数铭文进行交互。Goose支持MCP服务器的两种集成模式：作为本地进程运行服务器（STDIO）或通过服务器发送事件（SSE）作为远程服务连接到服务器。以下是这两种方法的说明：
使用STDIO（本地扩展）
此方法将MCP Inscription服务器作为Goose的子进程在本地运行，通过标准输入/输出进行通信。
- 克隆并构建MCP铭文库（如果您还没有）：
git clone https://github.com/Laz1mov/mcp-inscription
cd mcp-inscription
npm install
npm run build请注意存储库的完整绝对路径，因为您在下一步中将需要它。
- 在Goose中添加新扩展名： 打开Goose的配置界面。您可以通过命令行运行
goose configure，或在Goose Desktop应用程序中访问 设置>扩展。从菜单中选择 “添加扩展名。” (使用扩展|鹅)
- 选择扩展类型–命令行扩展： 当系统提示输入扩展类型时，选择 命令行扩展 （在CLI菜单或UI中），以便Goose知道它应该启动本地命令(使用扩展|鹅)（与内置或远程扩展相反）。
- 输入分机详细信息： 为MCP Inscription服务器提供名称和命令：
- 身份证件: mcp-inscription
- 姓名： 您可以称之为“mcp题词”，或任何标识符（这将是您引用扩展名的方式）。
- 命令： 指定构建的CLI脚本的完整路径。例如：
node /absolute/path/to/mcp-inscription/build/cli.js替换 /absolute/path/to/mcp-inscription 带有克隆存储库的实际路径。
- 您通常不需要在脚本路径之外添加任何参数（除非您的服务器需要特殊标志）。
- 使用新扩展启动Goose会话： 现在，您可以在Goose中使用该扩展。如果您通过CLI运行Goose，请运行以下命令启动包含扩展的会话：
goose session --with-extension "mcp-inscription"将“ordinals”替换为您为扩展名指定的任何名称(使用扩展|鹅).（这可确保会话加载扩展。或者，如果扩展是全局启用的，Goose Desktop或CLI将自动使其在所有会话中可用。）
使用SSE（远程扩展）
此方法通过HTTP SSE流将Goose连接到已运行的MCP服务器。如果您想将MCP Inscription服务器作为独立服务运行（可能在另一台机器上或仅独立于Goose），请使用此选项。
- 将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 （或您指定的端口）。
- 输入远程扩展详细信息： 为扩展名命名（例如“ordinals”）并提供服务器的URL 统一资源定位符，输入运行MCP服务器的基址。例如，如果您的服务器正在侦听本地计算机上的端口9000，您可以输入
http://localhost:9000.Gose将尝试连接到该地址的MCP服务器的SSE端点。（Goose使用标准MCP SSE路径，按照惯例，该路径位于/mcp/sse在服务器上路由时，通常只需要提供主机和端口，其余的由Goose处理。）
- 启用扩展： 添加远程扩展后，确保在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桌面应用程序）一起使用，请执行以下步骤：
- 下载并安装Claude Desktop： 访问Claude Desktop官方下载页面，获取适用于您的操作系统（macOS或Windows）的应用程序(安装桌面版Claude | Anthropic帮助中心).安装应用程序并确保您使用的是最新版本（您可以在应用程序菜单中检查更新）。
- 克隆并构建MCP铭文库：
git clone https://github.com/Laz1mov/mcp-inscription
cd mcp-inscription
npm install
npm run build- 配置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 包含克隆存储库的实际完整路径。
- 重新启动克劳德桌面： 保存
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许可证.