[{"_1":2,"_469":-5,"_470":-5},"loaderData",{"_3":4,"_24":25,"_296":297},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":22,"_23":-5},"attributes",[15],"bot","id",25525284,"membership","referenceId","019a8532-3486-77ed-91a9-43b1bf5feeec","unreadReleaseNotesCount",2,"userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_69":-5,"_70":28,"_29":71,"_214":215,"_294":295},"availableLocales",[28,41,48,55,62],{"_29":30,"_37":38,"_39":40},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","A collection of Bitcoin SV tools for the Model Context Protocol that enables AI assistants to interact with the BSV blockchain through wallet operations, ordinals (NFTs), and various blockchain utilities.","displayName","Bitcoin SV MCP Server","readme","# Bitcoin SV MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@b-open-io/bsv-mcp)](https://smithery.ai/server/@b-open-io/bsv-mcp)\n\n> **⚠️ NOTICE: Experimental Work in Progress** \n> This project is in an early experimental stage. Features may change, and the API is not yet stable.\n> Contributions, feedback, and bug reports are welcome! Feel free to open issues or submit pull requests.\n\nA collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework. This library provides wallet, ordinals, and utility functions for BSV blockchain interaction.\n\n## Installation and Setup\n\n### Use Bun (Optional but recommended)\n\nThis project is built using [Bun](https://bun.sh/), a fast JavaScript runtime and package manager. While Bun is recommended for best performance, the server can also run with Node.js and npm as Bun is designed to be backward compatible with node.\n\n#### Installing Bun\n\n**macOS (using Homebrew):**\n```bash\nbrew install oven-sh/bun/bun\n```\n\n**macOS/Linux/WSL (using installer script):**\n```bash\ncurl -fsSL https://bun.sh/install | bash\n```\n\n**Windows:**\nWindows users should use WSL (Windows Subsystem for Linux) or Docker to run Bun.\n\nNode.js and npm will also work but may not offer the same performance benefits.\n\n## Connecting to MCP Clients\n\nThis server implements the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP), allowing AI assistants to utilize Bitcoin SV functionalities. You can connect this server to various MCP-compatible clients.\n\n![MCP Configuration Example](docs/images/mcp-config-example.png)\n\n> **Note:** The `PRIVATE_KEY_WIF` environment variable is now optional. Without it, the server runs in limited mode with educational resources and non-wallet tools available. Wallet and MNEE token operations require a valid private key. You can also set the `IDENTITY_KEY_WIF` environment variable to enable sigma-protocol signing of ordinals inscriptions for authentication, curation, and web-of-trust.\n\n### Cursor\n\nTo use the BSV MCP server with [Cursor](https://cursor.sh/):\n\n1. Install Cursor if you haven't already\n2. Open Cursor and navigate to Settings → Extensions → Model Context Protocol\n3. Click \"Add a new global MCP server\"\n4. Enter the following configuration in JSON format:\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bunx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n5. Replace `` with your actual private key WIF (keep this secure!) If you dont have one you can leave this off for now but you wont be able to use tools that require a wallet. `` is also optional. It will sign 1Sat Ordinals with Sigma protocol using the provided identity key.\n\n6. Click \"Save\"\n\nThe BSV tools will now be available to Cursor's AI assistant under the \"Bitcoin SV\" namespace.\n\n#### Alternative for npm users\n\nIf you prefer to use npm instead of Bun:\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"npx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n### Claude for Desktop\n\nTo connect this server to Claude for Desktop:\n\n1. Open [Claude for Desktop](https://claude.ai/desktop) and go to Claude > Settings > Developer\n2. Click \"Edit Config\". \n\nOpen the Claude configuration json file in your favorite text editor. If you prefer to do it from the cli:\n\n ```bash\n # macOS/Linux\n code ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n\n # Windows\n code %APPDATA%\\Claude\\claude_desktop_config.json\n ```\n\n3. Add the BSV MCP server to your configuration:\n ```json\n {\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bun\",\n \"args\": [\n \"run\", \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n }\n ```\n4. Replace `` with your actual private key WIF\n5. Save the file and restart Claude for Desktop\n6. The BSV tools will appear when you click the tools icon (hammer) in Claude for Desktop\n\n#### Alternative for npm users (Claude)\n\nIf you prefer to use npm instead of Bun, replace the \"command\" field with \"npx\".\n\n## Available Tools\n\nThe toolkit is organized into several categories:\n\n### Wallet Tools\n\nWallet tools provide core BSV wallet functionality:\n\n| Tool Name | Description | Example Output |\n| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |\n| `wallet_getPublicKey` | Retrieves a public key for a specified protocol and key ID | `{\"publicKey\":\"032d0c73eb9270e9e009fd1f9dd77e19cf764fbad5f799560c4e8fd414e40d6fc2\"}` |\n| `wallet_createSignature` | Creates a cryptographic signature for the provided data | `{\"signature\":[144,124,85,193,226,45,140,249,9,177,11,167,33,215,209,38,...]}` |\n| `wallet_verifySignature` | Verifies a cryptographic signature against the provided data | `{\"isValid\":true}` |\n| `wallet_encryption` | Combined tool for encrypting and decrypting data using the wallet's cryptographic keys.

**Examples:**
1. Encrypt text: `\"Encrypt this message: Hello World\"`
2. Decrypt data: `\"Decrypt this data that was previously encrypted for me\"` | Encrypt: `{\"ciphertext\":[89,32,155,38,125,22,49,226,26,...]}`
Decrypt: `{\"plaintext\":\"hello world\"}` |\n| `wallet_getAddress` | Returns a BSV address for the current wallet or a derived path | `{\"address\":\"1ExampleBsvAddressXXXXXXXXXXXXXXXXX\",\"status\":\"ok\"}` |\n| `wallet_sendToAddress` | Sends BSV to a specified address (supports BSV or USD amounts) | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"satoshis\":1000000}` |\n| `wallet_purchaseListing` | Purchases NFTs or BSV-20/BSV-21 tokens from marketplace listings | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"type\":\"nft\",\"origin\":\"abcdef123456...\"}` |\n| `wallet_createOrdinals` | Creates and inscribes ordinals on the BSV blockchain | `{\"txid\":\"a1b2c3d4e5f6...\",\"inscriptionAddress\":\"1ExampleAddress...\",\"contentType\":\"image/png\"}` |\n\n### BSV Tools\n\nTools for interacting with the BSV blockchain and network:\n\n| Tool Name | Description | Example Output |\n| ----------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |\n| `bsv_getPrice` | Gets the current BSV price from an exchange API | `Current BSV price: $38.75 USD` |\n| `bsv_decodeTransaction` | Decodes a BSV transaction and returns detailed information | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,\"inputs\":[...],\"outputs\":[...]}` |\n| `bsv_explore` | Comprehensive blockchain explorer tool accessing WhatsOnChain API endpoints | `{\"chain_info\":{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}}` |\n\n### Ordinals Tools\n\nTools for working with ordinals (NFTs) on BSV:\n\n| Tool Name | Description | Example Output |\n| ------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |\n| `ordinals_getInscription` | Retrieves detailed information about a specific inscription | `{\"id\":\"a1b2c3d4e5f6...\",\"origin\":\"a1b2c3d4e5f6...\",\"contentType\":\"image/png\",\"content\":\"iVBORw0KGgoAAA...\"}` |\n| `ordinals_searchInscriptions` | Searches for inscriptions based on various criteria | `{\"results\":[{\"id\":\"a1b2c3...\",\"contentType\":\"image/png\",\"owner\":\"1Example...\"},...]}` |\n| `ordinals_marketListings` | Retrieves market listings for NFTs, BSV-20, and BSV-21 tokens with unified interface | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":9990000,\"tick\":\"PEPE\",\"listing\":true},...]}` |\n| `ordinals_marketSales` | Gets information about BSV-20 and BSV-21 token market sales | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":34710050,\"tick\":\"$BTC\",\"sale\":true},...]}` |\n| `ordinals_getTokenByIdOrTicker` | Retrieves details about a specific BSV20 token by ID | `{\"tick\":\"PEPE\",\"max\":\"21000000\",\"lim\":\"1000\",\"dec\":\"2\"}` |\n\n### Utility Tools\n\nGeneral-purpose utility functions:\n\n| Tool Name | Description | Example Output |\n| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- |\n| `utils_convertData` | Converts data between different encoding formats (utf8, hex, base64, binary).

**Parameters:**
- `data` (required): The string to convert
- `from` (required): Source encoding format (utf8, hex, base64, or binary)
- `to` (required): Target encoding format (utf8, hex, base64, or binary)

**Examples:**
- UTF-8 to hex: `{\"data\": \"hello world\", \"from\": \"utf8\", \"to\": \"hex\"}` → `68656c6c6f20776f726c64`
- UTF-8 to base64: `{\"data\": \"Hello World\", \"from\": \"utf8\", \"to\": \"base64\"}` → `SGVsbG8gV29ybGQ=`
- base64 to UTF-8: `{\"data\": \"SGVsbG8gV29ybGQ=\", \"from\": \"base64\", \"to\": \"utf8\"}` → `Hello World`
- hex to base64: `{\"data\": \"68656c6c6f20776f726c64\", \"from\": \"hex\", \"to\": \"base64\"}` → `aGVsbG8gd29ybGQ=`

**Notes:**
- All parameters are required
- The tool returns the converted data as a string
- For binary conversion, data is represented as an array of byte values | `\"SGVsbG8gV29ybGQ=\"` (UTF-8 \"Hello World\" converted to base64) |\n\n### MNEE Tools\n\nTools for working with MNEE tokens:\n\n| Tool Name | Description | Example Output |\n| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `mnee_getBalance` | Retrieves the current MNEE token balance for the wallet | `{\"balance\": {\"amount\": 2900, \"decimalAmount\": 0.029}}` |\n| `mnee_sendMnee` | Send MNEE tokens to a specified address. Supports both MNEE and USD amounts | `{\"success\": true, \"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"rawtx\": \"0100000002a0be40d8942015f1...\", \"mneeAmount\": 0.01, \"usdAmount\": \"$0.01\", \"recipient\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\"}` |\n| `mnee_parseTx` | Parse an MNEE transaction to get detailed information about its operations and amounts. All amounts are in atomic units with 5 decimal precision (e.g. 1000 atomic units = 0.01 MNEE) | `{\"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"environment\": \"production\", \"type\": \"transfer\", \"inputs\": [{\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 2900}], \"outputs\": [{\"address\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\", \"amount\": 1000}, {\"address\": \"19Vq2TV8aVhFNLQkhDMdnEQ7zT96x6F3PK\", \"amount\": 100}, {\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 1800}]}` |\n\n## Using the Tools with MCP\n\nOnce connected, you can use natural language to interact with Bitcoin SV through your AI assistant. Here are some example prompts:\n\n### Wallet Operations\n\n- \"Get my Bitcoin SV address\"\n- \"Send 0.01 BSV to 1ExampleBsvAddressXXXXXXXXXXXXXXXXX\"\n- \"Send $5 USD worth of BSV to 1ExampleBsvAddressXXXXXXXXXXXXXXXXX\"\n- \"Send 0.01 MNEE to 1ExampleBsvAddressXXXXXXXXXXXXXXXXX\"\n- \"Check my MNEE balance\"\n- \"Parse this MNEE transaction: txid\"\n- \"Encrypt this message using my wallet's keys\"\n- \"Decrypt this data that was previously encrypted for me\"\n- \"Purchase this NFT listing: txid_vout\"\n- \"Purchase this BSV-20 token listing: txid_vout\"\n\n### Ordinals (NFTs)\n\n- \"Show me information about the NFT with outpoint 6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325_0\"\n- \"Search for Pixel Zoide NFTs\"\n- \"Show me the current marketplace listings for BSV NFTs\"\n- \"Show me BSV-20 token listings for ticker PEPE\"\n- \"Get recent BSV-20 token sales\"\n\n### Blockchain Operations\n\n- \"What is the current BSV price?\"\n- \"Decode this BSV transaction: (transaction hex or ID)\"\n- \"Get the latest Bitcoin SV chain information\"\n- \"Show me block details for height 800000\"\n- \"Explore transaction history for address 1ExampleBsvAddressXXXX\"\n- \"Check unspent outputs (UTXOs) for my wallet address\"\n- \"Get details for transaction with hash a1b2c3d4e5f6...\"\n\n### Data Conversion\n\n- \"Convert 'Hello World' from UTF-8 to hex format\"\n\n## MCP Prompts and Resources\n\nThe BSV MCP server exposes specialized prompts and resources that provide detailed information and context about Bitcoin SV technologies. These can be accessed by AI models to enhance their understanding and capabilities.\n\n### Available Prompts\n\nThe server provides the following educational prompts that can be accessed directly via the MCP protocol:\n\n#### Ordinals Prompt\n- **Identifier**: `bitcoin_sv_ordinals`\n- **Description**: Comprehensive information about Bitcoin SV ordinals, including what they are, how they work, and how to use them.\n- **Usage**: Ask the assistant about \"Bitcoin SV ordinals\" or \"1Sat Ordinals\" to access this information.\n\n#### BSV SDK Prompts\nA collection of prompts providing detailed information about the Bitcoin SV SDK:\n\n- **Overview**\n - **Identifier**: `bitcoin_sv_sdk_overview`\n - **Description**: General overview of the Bitcoin SV SDK, including its purpose and main components.\n - **Usage**: \"Tell me about the BSV SDK\" or \"What is the Bitcoin SV SDK?\"\n\n- **Wallet Operations**\n - **Identifier**: `bitcoin_sv_sdk_wallet`\n - **Description**: Information about wallet operations in the BSV SDK.\n - **Usage**: \"How do wallet operations work in the BSV SDK?\"\n\n- **Transaction Building**\n - **Identifier**: `bitcoin_sv_sdk_transaction`\n - **Description**: Details about transaction creation and manipulation.\n - **Usage**: \"Explain BSV SDK transaction building\" or \"How do I create transactions with BSV SDK?\"\n\n- **Authentication**\n - **Identifier**: `bitcoin_sv_sdk_auth`\n - **Description**: Authentication and identity protocols in BSV SDK.\n - **Usage**: \"How does authentication work with BSV SDK?\"\n\n- **Cryptography**\n - **Identifier**: `bitcoin_sv_sdk_cryptography`\n - **Description**: Signing, encryption, and verification functionality.\n - **Usage**: \"Explain BSV SDK cryptography features\"\n\n- **Scripting**\n - **Identifier**: `bitcoin_sv_sdk_script`\n - **Description**: Bitcoin scripting and contract capabilities.\n - **Usage**: \"How do I work with Bitcoin scripts using the BSV SDK?\"\n\n- **Primitives**\n - **Identifier**: `bitcoin_sv_sdk_primitives`\n - **Description**: Core data types and structures in the BSV SDK.\n - **Usage**: \"What primitives are available in the BSV SDK?\"\n\n### Available Resources\n\nThe server also provides access to Bitcoin Request for Comments (BRC) specifications and documentation:\n\n#### Changelog Resource\n- **Identifier**: `bsv-mcp-changelog`\n- **Description**: Version history and changelog for the BSV MCP server.\n- **Usage**: \"Show me the BSV MCP changelog\" or \"What's new in the latest version?\"\n\n#### BRC Resources\n- **BRCs Overview**\n - **Identifier**: `brcs_readme`\n - **Description**: Overview of all Bitcoin SV protocol specifications in the BRCs repository.\n - **Usage**: \"Show me the Bitcoin SV BRCs overview\"\n\n- **BRCs Summary**\n - **Identifier**: `brcs_summary`\n - **Description**: Table of contents for all Bitcoin SV BRCs.\n - **Usage**: \"Give me a summary of Bitcoin SV BRCs\"\n\n- **Specific BRC Specifications**\n - **Identifier**: `brc_spec`\n - **Description**: Access specific BRC specifications by category and number.\n - **Usage**: \"Show me BRC 8 on Transaction Envelopes\" or \"What does BRC 1 specify?\"\n\n#### BRC Categories\nThe BRC specifications are organized into the following categories:\n- Wallet\n- Transactions\n- Scripts\n- Tokens\n- Overlays\n- Payments\n- Peer-to-Peer\n- Key Derivation\n- Outpoints\n- Opinions\n- State Machines\n- Apps\n\n### Using Prompts and Resources\n\nAI models can use these prompts and resources to provide more accurate and detailed responses about Bitcoin SV technologies. As a user, you can:\n\n1. **Ask about a specific topic**: \"Tell me about Bitcoin SV ordinals\" or \"Explain BSV SDK transaction building\"\n2. **Request specific BRC details**: \"What does BRC 8 specify?\" or \"Show me the BRC on Transaction Creation\"\n3. **Get general overviews**: \"What is the BSV SDK?\" or \"Show me a summary of all BRCs\"\n\nThese prompts and resources enhance the AI's knowledge base, enabling more technical and accurate responses even for complex Bitcoin SV topics.\n\n## How MCP Works\n\nWhen you interact with an MCP-enabled AI assistant:\n\n1. The AI analyzes your request and decides which tools to use\n2. With your approval, it calls the appropriate BSV MCP tool\n3. The server executes the requested operation on the Bitcoin SV blockchain\n4. The results are returned to the AI assistant\n5. The assistant presents the information in a natural, conversational way\n\n## Customization Options\n\nThe BSV MCP server can be customized using environment variables to enable or disable specific components:\n\n### Component Configuration\n\n| Environment Variable | Default | Description |\n| -------------------- | ------- | ----------- |\n| `DISABLE_PROMPTS` | `false` | Set to `true` to disable all educational prompts |\n| `DISABLE_RESOURCES` | `false` | Set to `true` to disable all resources (BRCs, changelog) |\n| `DISABLE_TOOLS` | `false` | Set to `true` to disable all tools |\n\n### Tool-Specific Configuration\n\n| Environment Variable | Default | Description |\n| -------------------- | ------- | ----------- |\n| `DISABLE_WALLET_TOOLS` | `false` | Set to `true` to disable Bitcoin wallet tools |\n| `DISABLE_MNEE_TOOLS` | `false` | Set to `true` to disable MNEE token tools |\n| `DISABLE_BSV_TOOLS` | `false` | Set to `true` to disable BSV blockchain tools |\n| `DISABLE_ORDINALS_TOOLS` | `false` | Set to `true` to disable Ordinals/NFT tools |\n| `DISABLE_UTILS_TOOLS` | `false` | Set to `true` to disable utility tools |\n| `IDENTITY_KEY_WIF` | `not set` | Optional WIF for identity key; if set, ordinals inscriptions will be signed with sigma-protocol for authentication, curation, and web-of-trust. |\n| `DISABLE_BROADCASTING` | `false` | Set to `true` to disable transaction broadcasting; returns raw transaction hex instead - useful for testing and transaction review before broadcasting |\n\n### Examples\n\nRun with only educational resources and prompts, no tools:\n\n```bash\nDISABLE_TOOLS=true bunx bsv-mcp@latest\n```\n\nRun with only BSV tools, no wallet or other functionality:\n\n```bash\nDISABLE_PROMPTS=true DISABLE_RESOURCES=true DISABLE_WALLET_TOOLS=true DISABLE_MNEE_TOOLS=true DISABLE_ORDINALS_TOOLS=true DISABLE_UTILS_TOOLS=true bunx bsv-mcp@latest\n```\n\nUse all tools except wallet operations:\n\n```bash\nDISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest\n```\n\nCreate transactions without broadcasting them (dry-run mode):\n\n```bash\nDISABLE_BROADCASTING=true bunx bsv-mcp@latest\n```\n\n## Troubleshooting\n\nIf you're having issues with the BSV MCP server:\n\n### Connection Issues\n\n1. Make sure Bun or Node.js is installed on your system\n2. Verify your WIF private key is correctly set in the environment\n3. Check that your client supports MCP and is properly configured\n4. Look for error messages in the client's console output\n\n### Keeping Bun Up to Date\n\nIt's important to keep Bun updated to the latest version to ensure compatibility:\n\n```bash\n# Update Bun to the latest version\nbun upgrade\n```\n\nTo verify your current Bun version:\n```bash\nbun --version\n```\n\n### Logging and Debugging\n\nFor Claude for Desktop, check the logs at:\n\n```bash\n# macOS/Linux\ntail -n 20 -f ~/Library/Logs/Claude/mcp*.log\n\n# Windows\ntype %APPDATA%\\Claude\\Logs\\mcp*.log\n```\n\nFor Cursor, check the Cursor MCP logs in Settings → Extensions → Model Context Protocol.\n\n## Recent Updates\n\n- **Transaction Broadcast Control**: Added `DISABLE_BROADCASTING` environment variable to prevent transactions from being broadcast to the network\n- **Blockchain Explorer**: Added `bsv_explore` tool for WhatsOnChain API access with mainnet/testnet support\n- **Unified Tools**: Merged `wallet_encrypt`/`wallet_decrypt` into single `wallet_encryption` tool\n- **Enhanced Marketplace**: Support for NFTs, BSV-20/21 tokens in listings, sales and purchases\n- **Performance**: Added price caching and optimized API endpoint structure\n- **Improved Validation**: Better error handling for private keys and parameters\n\n## Bitcoin SV Blockchain Explorer\n\nThe `bsv_explore` tool provides comprehensive access to the Bitcoin SV blockchain through the WhatsOnChain API. This powerful explorer tool allows you to query various aspects of the blockchain, including chain data, blocks, transactions, and address information.\n\n### Available Endpoints\n\nThe tool supports the following endpoint categories and specific endpoints:\n\n#### Chain Data\n\n| Endpoint | Description | Required Parameters | Example Response |\n| -------------------- | ----------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------- |\n| `chain_info` | Network statistics, difficulty, and chain work | None | `{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}` |\n| `chain_tips` | Current chain tips including heights and states | None | `[{\"height\":826458,\"hash\":\"000000000000...\",\"branchlen\":0,\"status\":\"active\"}]` |\n| `circulating_supply` | Current BSV circulating supply | None | `{\"bsv\":21000000}` |\n| `peer_info` | Connected peer statistics | None | `[{\"addr\":\"1.2.3.4:8333\",\"services\":\"000000000000...\",\"lastsend\":1621234567}]` |\n\n#### Block Data\n\n| Endpoint | Description | Required Parameters | Example Response |\n| --------------------- | --------------------------------------------------- | ----------------------------------- | -------------------------------------------------------------------------- |\n| `block_by_hash` | Complete block data via hash | `blockHash` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `block_by_height` | Complete block data via height | `blockHeight` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `tag_count_by_height` | Stats on tag count for a specific block | `blockHeight` | `{\"tags\":{\"amp\":3,\"bitkey\":5,\"metanet\":12,\"planaria\":7,\"b\":120}}` |\n| `block_headers` | Retrieves the last 10 block headers | None | `[{\"hash\":\"000000000000...\",\"height\":826458,\"version\":536870912,...},...]` |\n| `block_pages` | Retrieves pages of transaction IDs for large blocks | `blockHash`, optional: `pageNumber` | `[\"tx1hash\",\"tx2hash\",\"tx3hash\",...]` |\n\n#### Stats Data\n\n| Endpoint | Description | Required Parameters | Example Response |\n| ----------------------- | ----------------------------------------- | ---------------------------- | -------------------------------------------------------------------------------------- |\n| `block_stats_by_height` | Block statistics for a specific height | `blockHeight` | `{\"size\":123456,\"txCount\":512,\"outputTotal\":54.12345678,\"outputTotalUsd\":2345.67,...}` |\n| `block_miner_stats` | Block mining statistics for a time period | optional: `days` (default 7) | `{\"blocks\":{\"miner1\":412,\"miner2\":208,...},\"total\":1008}` |\n| `miner_summary_stats` | Summary of mining statistics | optional: `days` (default 7) | `{\"totalBlocks\":1008,\"totalFees\":1.23456789,\"totalFeesUsd\":53.67,...}` |\n\n#### Transaction Data\n\n| Endpoint | Description | Required Parameters | Example Response |\n| ----------------- | --------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------ |\n| `tx_by_hash` | Detailed transaction data | `txHash` | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,...}` |\n| `tx_raw` | Raw transaction hex data | `txHash` | `\"01000000012345abcdef...\"` |\n| `tx_receipt` | Transaction receipt | `txHash` | `{\"blockHash\":\"000000000000...\",\"blockHeight\":800000,\"confirmations\":26458}` |\n| `bulk_tx_details` | Retrieve multiple transactions in one request | `txids` (array) | `[{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,...}, {\"txid\":\"b2c3d4e5f6a7...\",\"version\":1,...}]` |\n\n#### Address Data\n\n| Endpoint | Description | Required Parameters | Example Response |\n| ----------------- | ------------------------------- | ---------------------------- | --------------------------------------------------------------- |\n| `address_history` | Transaction history for address | `address`, optional: `limit` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"height\":800000},...]` |\n| `address_utxos` | Unspent outputs for address | `address` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"tx_pos\":0,\"value\":100000},...]` |\n\n#### Network\n\n| Endpoint | Description | Required Parameters | Example Response |\n| -------- | ---------------- | ------------------- | --------------------- |\n| `health` | API health check | None | `{\"status\":\"synced\"}` |\n\n### Usage Examples\n\nThe `bsv_explore` tool can be used with natural language prompts like:\n\n```\n\"Get the current Bitcoin SV blockchain information\"\n\"Show me block #800000 details\"\n\"Get tag count statistics for block #800000\"\n\"Fetch transaction history for address 1ExampleBsvAddressXXXXXXXX\"\n\"Get unspent outputs for my wallet address\"\n\"Check transaction details for txid a1b2c3d4e5f6...\"\n\"What is the current BSV circulating supply?\"\n\"Show me the latest block headers\"\n\"Get transaction IDs for page 2 of a large block\"\n\"Show me block statistics for height 800000\"\n\"What are the mining statistics for the last 14 days?\"\n\"Get a summary of mining activity over the past 30 days\"\n\"Retrieve details for multiple transactions in a single query\"\n```\n\nUnder the hood, the tool accepts parameters to specify which data to retrieve:\n\n- `endpoint`: The specific WhatsOnChain endpoint to query (e.g., `chain_info`, `tx_by_hash`)\n- `network`: The BSV network to use (`main` or `test`)\n- Additional parameters as required by the specific endpoint:\n - `blockHash`: For block_by_hash and block_pages endpoints\n - `blockHeight`: For block_by_height, tag_count_by_height, and block_stats_by_height endpoints\n - `pageNumber`: For block_pages endpoint (pagination)\n - `days`: For block_miner_stats and miner_summary_stats endpoints (defaults to 7)\n - `txHash`: For transaction-related endpoints (tx_by_hash, tx_raw, tx_receipt)\n - `txids`: For bulk_tx_details endpoint (array of transaction IDs)\n - `address`: For address-related endpoints\n - `limit`: Optional pagination limit for address_history\n\n### Network Options\n\nThe tool supports both mainnet and testnet:\n\n- `main`: Bitcoin SV mainnet (default)\n- `test`: Bitcoin SV testnet\n\n# Development\n\n## Project Setup\n\nIf you want to contribute to the project or run it locally:\n\n1. Clone the repository:\n ```bash\n git clone https://github.com/b-open-io/bsv-mcp.git\n cd bsv-mcp\n ```\n\n2. Install dependencies:\n ```bash\n bun install\n # or with npm\n npm install\n ```\n\n## Running the Server\n\n```bash\nbun run index.ts\n# or with npm\nnpm run start\n```\n\n### Running Tests\n\n```bash\nbun test\n# or with npm\nnpm test\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","name","English","tag","en-US",{"_29":42,"_37":46,"_39":47},{"_31":43,"_33":44,"_35":45},"Una colección de herramientas de Bitcoin SV para el Protocolo de Contexto de Modelo que permite a los asistentes de IA interactuar con la cadena de bloques BSV a través de operaciones de billetera, ordinales (NFT) y varias utilidades de cadena de bloques.","Servidor MCP de Bitcoin SV","# Servidor MCP de Bitcoin SV\n\n[![insignia de herrería](https://smithery.ai/badge/@b-open-io/bsv-mcp)](https://smithery.ai/server/@b-open-io/bsv-mcp)\n\n> **⚠️ AVISO: Trabajo experimental en progreso**\\\n> Este proyecto se encuentra en una fase experimental inicial. Las características pueden cambiar y la API aún no es estable. ¡Agradecemos sus contribuciones, comentarios e informes de errores! No dude en abrir incidencias o enviar solicitudes de incorporación de cambios.\n\nUna colección de herramientas de Bitcoin SV (BSV) para el marco del Protocolo de Contexto de Modelo (MCP). Esta biblioteca proporciona funciones de billetera, ordinales y utilidades para la interacción con la blockchain de BSV.\n\n## Instalación y configuración\n\n### Usar pan (opcional pero recomendado)\n\nEste proyecto se creó con [Bun](https://bun.sh/) , un entorno de ejecución rápido de JavaScript y gestor de paquetes. Si bien se recomienda Bun para un rendimiento óptimo, el servidor también puede ejecutarse con Node.js y npm, ya que Bun está diseñado para ser retrocompatible con Node.\n\n#### Instalación de Bun\n\n**macOS (usando Homebrew):**\n\n```bash\nbrew install oven-sh/bun/bun\n```\n\n**macOS/Linux/WSL (usando el script de instalación):**\n\n```bash\ncurl -fsSL https://bun.sh/install | bash\n```\n\n**Windows:** los usuarios de Windows deben usar WSL (Subsistema de Windows para Linux) o Docker para ejecutar Bun.\n\nNode.js y npm también funcionarán, pero es posible que no ofrezcan los mismos beneficios de rendimiento.\n\n## Conexión a clientes MCP\n\nEste servidor implementa el [Protocolo de Contexto de Modelo](https://modelcontextprotocol.io/) (MCP), lo que permite a los asistentes de IA utilizar las funcionalidades de Bitcoin SV. Puede conectar este servidor a varios clientes compatibles con MCP.\n\n![Ejemplo de configuración de MCP](docs/images/mcp-config-example.png)\n\n> **Nota:** La variable de entorno `PRIVATE_KEY_WIF` ahora es opcional. Sin ella, el servidor funciona en modo limitado, con recursos educativos y herramientas que no son de billetera disponibles. Las operaciones con billeteras y tokens MNEE requieren una clave privada válida. También puede configurar la variable de entorno `IDENTITY_KEY_WIF` para habilitar la firma con protocolo sigma de inscripciones de ordinales para autenticación, curación y web de confianza.\n\n### Cursor\n\nPara utilizar el servidor BSV MCP con [Cursor](https://cursor.sh/) :\n\n1. Instala Cursor si aún no lo has hecho\n2. Abra Cursor y navegue a Configuración → Extensiones → Protocolo de contexto de modelo\n3. Haga clic en \"Agregar un nuevo servidor MCP global\"\n4. Introduzca la siguiente configuración en formato JSON:\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bunx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n5. Reemplaza `` con tu clave privada WIF (¡mantenla segura!). Si no tienes una, puedes omitirla por ahora, pero no podrás usar herramientas que requieran una billetera. `` también es opcional. Firmará los ordinales 1Sat con el protocolo Sigma usando la clave de identidad proporcionada.\n\n6. Haga clic en \"Guardar\"\n\nLas herramientas BSV ahora estarán disponibles para el asistente de inteligencia artificial de Cursor bajo el espacio de nombres \"Bitcoin SV\".\n\n#### Alternativa para usuarios de npm\n\nSi prefieres usar npm en lugar de Bun:\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"npx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n### Claude para escritorio\n\nPara conectar este servidor a Claude for Desktop:\n\n1. Abra [Claude para escritorio](https://claude.ai/desktop) y vaya a Claude > Configuración > Desarrollador\n2. Haga clic en \"Editar configuración\".\n\nAbra el archivo JSON de configuración de Claude en su editor de texto favorito. Si prefiere hacerlo desde la CLI:\n\n```bash\n# macOS/Linux\ncode ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n\n# Windows\ncode %APPDATA%\\Claude\\claude_desktop_config.json\n```\n\n3. Agregue el servidor BSV MCP a su configuración:\n\n ```json\n {\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bun\",\n \"args\": [\n \"run\", \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n }\n ```\n\n4. Reemplace `` con su clave privada WIF real\n\n5. Guarde el archivo y reinicie Claude for Desktop\n\n6. Las herramientas BSV aparecerán cuando haga clic en el ícono de herramientas (martillo) en Claude para escritorio\n\n#### Alternativa para usuarios de npm (Claude)\n\nSi prefiere utilizar npm en lugar de Bun, reemplace el campo \"comando\" con \"npx\".\n\n## Herramientas disponibles\n\nEl kit de herramientas está organizado en varias categorías:\n\n### Herramientas de billetera\n\nLas herramientas de billetera proporcionan la funcionalidad principal de la billetera BSV:\n\n| Nombre de la herramienta | Descripción | Ejemplo de salida |\n| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |\n| `wallet_getPublicKey` | Recupera una clave pública para un protocolo y un ID de clave específicos | `{\"publicKey\":\"032d0c73eb9270e9e009fd1f9dd77e19cf764fbad5f799560c4e8fd414e40d6fc2\"}` |\n| `wallet_createSignature` | Crea una firma criptográfica para los datos proporcionados | `{\"signature\":[144,124,85,193,226,45,140,249,9,177,11,167,33,215,209,38,...]}` |\n| `wallet_verifySignature` | Verifica una firma criptográfica con los datos proporcionados | `{\"isValid\":true}` |\n| `wallet_encryption` | Herramienta combinada para cifrar y descifrar datos mediante las claves criptográficas de la billetera. **Ejemplos:** 1. Cifrar texto: `\"Encrypt this message: Hello World\"` 2. Descifrar datos: `\"Decrypt this data that was previously encrypted for me\"` | Cifrar: `{\"ciphertext\":[89,32,155,38,125,22,49,226,26,...]}` Descifrar: `{\"plaintext\":\"hello world\"}` |\n| `wallet_getAddress` | Devuelve una dirección BSV para la billetera actual o una ruta derivada | `{\"address\":\"1ExampleBsvAddressXXXXXXXXXXXXXXXXX\",\"status\":\"ok\"}` |\n| `wallet_sendToAddress` | Envía BSV a una dirección específica (admite montos en BSV o USD) | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"satoshis\":1000000}` |\n| `wallet_purchaseListing` | Compra NFT o tokens BSV-20/BSV-21 de los listados del mercado | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"type\":\"nft\",\"origin\":\"abcdef123456...\"}` |\n| `wallet_createOrdinals` | Crea e inscribe ordinales en la cadena de bloques BSV | `{\"txid\":\"a1b2c3d4e5f6...\",\"inscriptionAddress\":\"1ExampleAddress...\",\"contentType\":\"image/png\"}` |\n\n### Herramientas BSV\n\nHerramientas para interactuar con la cadena de bloques y la red BSV:\n\n| Nombre de la herramienta | Descripción | Ejemplo de salida |\n| ------------------------ | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |\n| `bsv_getPrice` | Obtiene el precio actual de BSV desde una API de intercambio | `Current BSV price: $38.75 USD` |\n| `bsv_decodeTransaction` | Decodifica una transacción BSV y devuelve información detallada | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,\"inputs\":[...],\"outputs\":[...]}` |\n| `bsv_explore` | Herramienta integral de exploración de blockchain que accede a los puntos finales de la API de WhatsOnChain | `{\"chain_info\":{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}}` |\n\n### Herramientas de ordinales\n\nHerramientas para trabajar con ordinales (NFT) en BSV:\n\n| Nombre de la herramienta | Descripción | Ejemplo de salida |\n| ------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |\n| `ordinals_getInscription` | Recupera información detallada sobre una inscripción específica | `{\"id\":\"a1b2c3d4e5f6...\",\"origin\":\"a1b2c3d4e5f6...\",\"contentType\":\"image/png\",\"content\":\"iVBORw0KGgoAAA...\"}` |\n| `ordinals_searchInscriptions` | Búsquedas de inscripciones basadas en diversos criterios | `{\"results\":[{\"id\":\"a1b2c3...\",\"contentType\":\"image/png\",\"owner\":\"1Example...\"},...]}` |\n| `ordinals_marketListings` | Recupera listados de mercado para tokens NFT, BSV-20 y BSV-21 con una interfaz unificada | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":9990000,\"tick\":\"PEPE\",\"listing\":true},...]}` |\n| `ordinals_marketSales` | Obtiene información sobre las ventas en el mercado de tokens BSV-20 y BSV-21 | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":34710050,\"tick\":\"$BTC\",\"sale\":true},...]}` |\n| `ordinals_getTokenByIdOrTicker` | Recupera detalles sobre un token BSV20 específico por ID | `{\"tick\":\"PEPE\",\"max\":\"21000000\",\"lim\":\"1000\",\"dec\":\"2\"}` |\n\n### Herramientas de utilidad\n\nFunciones de utilidad de propósito general:\n\n| Nombre de la herramienta | Descripción | Ejemplo de salida |\n| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |\n| `utils_convertData` | Convierte datos entre diferentes formatos de codificación (utf8, hex, base64, binario). **Parámetros:** - `data` (obligatorio): La cadena a convertir- `from` (obligatorio): Formato de codificación de origen (utf8, hexadecimal, base64 o binario)- `to` (obligatorio): Formato de codificación de destino (utf8, hexadecimal, base64 o binario) **Ejemplos:** - UTF-8 a hexadecimal: `{\"data\": \"hello world\", \"from\": \"utf8\", \"to\": \"hex\"}` → `68656c6c6f20776f726c64` - UTF-8 a base64: `{\"data\": \"Hello World\", \"from\": \"utf8\", \"to\": \"base64\"}` → `SGVsbG8gV29ybGQ=` - base64 a UTF-8: `{\"data\": \"SGVsbG8gV29ybGQ=\", \"from\": \"base64\", \"to\": \"utf8\"}` → `Hello World` - Hex a base64: `{\"data\": \"68656c6c6f20776f726c64\", \"from\": \"hex\", \"to\": \"base64\"}` → `aGVsbG8gd29ybGQ=` **Notas:** - Todos los parámetros son obligatorios. - La herramienta devuelve los datos convertidos como una cadena. - Para la conversión binaria, los datos se representan como una matriz de valores de bytes. | `\"SGVsbG8gV29ybGQ=\"` (UTF-8 \"Hola Mundo\" convertido a base64) |\n\n### Herramientas MNEE\n\nHerramientas para trabajar con tokens MNEE:\n\n| Nombre de la herramienta | Descripción | Ejemplo de salida |\n| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `mnee_getBalance` | Recupera el saldo actual del token MNEE para la billetera | `{\"balance\": {\"amount\": 2900, \"decimalAmount\": 0.029}}` |\n| `mnee_sendMnee` | Envía tokens MNEE a una dirección específica. Admite cantidades de MNEE y USD. | `{\"success\": true, \"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"rawtx\": \"0100000002a0be40d8942015f1...\", \"mneeAmount\": 0.01, \"usdAmount\": \"$0.01\", \"recipient\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\"}` |\n| `mnee_parseTx` | Analice una transacción MNEE para obtener información detallada sobre sus operaciones y montos. Todos los montos se expresan en unidades atómicas con una precisión de 5 decimales (p. ej., 1000 unidades atómicas = 0,01 MNEE). | `{\"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"environment\": \"production\", \"type\": \"transfer\", \"inputs\": [{\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 2900}], \"outputs\": [{\"address\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\", \"amount\": 1000}, {\"address\": \"19Vq2TV8aVhFNLQkhDMdnEQ7zT96x6F3PK\", \"amount\": 100}, {\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 1800}]}` |\n\n## Uso de las herramientas con MCP\n\nUna vez conectado, podrá interactuar con Bitcoin SV en lenguaje natural a través de su asistente de IA. Aquí tiene algunos ejemplos:\n\n### Operaciones de billetera\n\n* Obtener mi dirección de Bitcoin SV\n* \"Enviar 0,01 BSV a 1ExampleBsvAddressXXXXXXXXXXXXXXXXXX\"\n* \"Envía BSV por valor de $5 USD a 1ExampleBsvAddressXXXXXXXXXXXXXXXXXX\"\n* \"Enviar 0,01 MNEE a 1ExampleBsvAddressXXXXXXXXXXXXXXXXXX\"\n* Consultar mi saldo de MNEE\n* Analizar esta transacción MNEE: txid\n* \"Cifrar este mensaje con las claves de mi billetera\"\n* \"Descifrar estos datos que previamente fueron cifrados para mí\"\n* Compra este NFT: txid\\_vout\n* Compre este token BSV-20: txid\\_vout\n\n### Ordinales (NFT)\n\n* Muéstrame información sobre el NFT con el punto de salida 6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325\\_0\n* Búsqueda de NFT de Pixel Zoide\n* \"Muéstrame las listas actuales de NFT de BSV en el mercado\"\n* Muéstrame listados de tokens BSV-20 para el ticker PEPE.\n* Consulta las ventas recientes de tokens BSV-20.\n\n### Operaciones de blockchain\n\n* \"¿Cuál es el precio actual del BSV?\"\n* \"Decodificar esta transacción BSV: (código hexadecimal o ID de la transacción)\"\n* Obtén la información más reciente sobre la cadena Bitcoin SV.\n* \"Muéstrame los detalles del bloque para la altura 800000\"\n* Explorar el historial de transacciones de la dirección 1ExampleBsvAddressXXXX\n* \"Verificar las salidas no gastadas (UTXO) de mi dirección de billetera\"\n* Obtener detalles de la transacción con hash a1b2c3d4e5f6\n\n### Conversión de datos\n\n* Convertir \"Hola Mundo\" de UTF-8 a formato hexadecimal\n\n## Indicaciones y recursos de MCP\n\nEl servidor MCP de BSV ofrece indicaciones y recursos especializados que proporcionan información detallada y contexto sobre las tecnologías de Bitcoin SV. Los modelos de IA pueden acceder a ellos para mejorar su comprensión y capacidades.\n\n### Indicaciones disponibles\n\nEl servidor proporciona las siguientes indicaciones educativas a las que se puede acceder directamente a través del protocolo MCP:\n\n#### Indicación de ordinales\n\n* **Identificador** : `bitcoin_sv_ordinals`\n* **Descripción** : Información completa sobre los ordinales de Bitcoin SV, incluyendo qué son, cómo funcionan y cómo usarlos.\n* **Uso** : Pregunte al asistente sobre \"Ordinales de Bitcoin SV\" u \"Ordinales 1Sat\" para acceder a esta información.\n\n#### Indicaciones del SDK de BSV\n\nUna colección de indicaciones que brindan información detallada sobre el SDK de Bitcoin SV:\n\n* **Descripción general**\n\n * **Identificador** : `bitcoin_sv_sdk_overview`\n * **Descripción** : Descripción general del SDK de Bitcoin SV, incluido su propósito y componentes principales.\n * **Uso** : \"Cuéntame sobre el SDK de BSV\" o \"¿Qué es el SDK de Bitcoin SV?\"\n\n* **Operaciones de billetera**\n\n * **Identificador** : `bitcoin_sv_sdk_wallet`\n * **Descripción** : Información sobre las operaciones de billetera en el SDK de BSV.\n * **Uso** : \"¿Cómo funcionan las operaciones de billetera en el SDK de BSV?\"\n\n* **Edificio de transacciones**\n\n * **Identificador** : `bitcoin_sv_sdk_transaction`\n * **Descripción** : Detalles sobre la creación y manipulación de transacciones.\n * **Uso** : \"Explique la creación de transacciones con BSV SDK\" o \"¿Cómo creo transacciones con BSV SDK?\"\n\n* **Autenticación**\n\n * **Identificador** : `bitcoin_sv_sdk_auth`\n * **Descripción** : Protocolos de autenticación e identidad en BSV SDK.\n * **Uso** : \"¿Cómo funciona la autenticación con BSV SDK?\"\n\n* **Criptografía**\n\n * **Identificador** : `bitcoin_sv_sdk_cryptography`\n * **Descripción** : Funcionalidad de firma, cifrado y verificación.\n * **Uso** : \"Explicar las funciones criptográficas del SDK de BSV\"\n\n* **Scripting**\n\n * **Identificador** : `bitcoin_sv_sdk_script`\n * **Descripción** : Capacidades de creación de scripts y contratos de Bitcoin.\n * **Uso** : \"¿Cómo trabajo con scripts de Bitcoin usando el SDK BSV?\"\n\n* **Primitivos**\n\n * **Identificador** : `bitcoin_sv_sdk_primitives`\n * **Descripción** : Tipos de datos y estructuras principales en el SDK de BSV.\n * **Uso** : \"¿Qué primitivas están disponibles en el SDK de BSV?\"\n\n### Recursos disponibles\n\nEl servidor también proporciona acceso a las especificaciones y documentación de la Solicitud de comentarios (BRC) de Bitcoin:\n\n#### Recurso del registro de cambios\n\n* **Identificador** : `bsv-mcp-changelog`\n* **Descripción** : Historial de versiones y registro de cambios del servidor BSV MCP.\n* **Uso** : \"Muéstrame el registro de cambios de BSV MCP\" o \"¿Qué hay de nuevo en la última versión?\"\n\n#### Recursos de BRC\n\n* **Descripción general de los BRC**\n\n * **Identificador** : `brcs_readme`\n * **Descripción** : Descripción general de todas las especificaciones del protocolo Bitcoin SV en el repositorio BRC.\n * **Uso** : \"Muéstrame la descripción general de los BRC de Bitcoin SV\"\n\n* **Resumen de BRC**\n\n * **Identificador** : `brcs_summary`\n * **Descripción** : Tabla de contenidos de todos los BRC de Bitcoin SV.\n * **Uso** : \"Dame un resumen de los BRC de Bitcoin SV\"\n\n* **Especificaciones específicas de BRC**\n\n * **Identificador** : `brc_spec`\n * **Descripción** : Acceda a especificaciones BRC específicas por categoría y número.\n * **Uso** : \"Muéstrame BRC 8 en los sobres de transacción\" o \"¿Qué especifica BRC 1?\"\n\n#### Categorías BRC\n\nLas especificaciones BRC están organizadas en las siguientes categorías:\n\n* Billetera\n* Actas\n* Guiones\n* Fichas\n* Superposiciones\n* Pagos\n* De igual a igual\n* Derivación de claves\n* Puntos de salida\n* Opiniones\n* Máquinas de estados\n* Aplicaciones\n\n### Uso de indicaciones y recursos\n\nLos modelos de IA pueden usar estas indicaciones y recursos para proporcionar respuestas más precisas y detalladas sobre las tecnologías de Bitcoin SV. Como usuario, puedes:\n\n1. **Pregunte sobre un tema específico** : \"Cuénteme sobre los ordinales de Bitcoin SV\" o \"Explique la creación de transacciones del SDK de BSV\".\n2. **Solicitar detalles específicos del BRC** : \"¿Qué especifica el BRC 8?\" o \"Muéstrame el BRC al crear la transacción\".\n3. **Obtenga descripciones generales** : \"¿Qué es el SDK de BSV?\" o \"Muéstrame un resumen de todos los BRC\".\n\nEstas indicaciones y recursos mejoran la base de conocimientos de la IA, lo que permite respuestas más técnicas y precisas incluso para temas complejos de Bitcoin SV.\n\n## Cómo funciona MCP\n\nCuando interactúas con un asistente de IA habilitado para MCP:\n\n1. La IA analiza tu solicitud y decide qué herramientas utilizar\n2. Con su aprobación, llama a la herramienta BSV MCP adecuada\n3. El servidor ejecuta la operación solicitada en la cadena de bloques de Bitcoin SV\n4. Los resultados se devuelven al asistente de IA.\n5. El asistente presenta la información de forma natural y conversacional.\n\n## Opciones de personalización\n\nEl servidor BSV MCP se puede personalizar mediante variables de entorno para habilitar o deshabilitar componentes específicos:\n\n### Configuración de componentes\n\n| Variable de entorno | Por defecto | Descripción |\n| ------------------- | ----------- | -------------------------------------------------------------------------------------- |\n| `DISABLE_PROMPTS` | `false` | Establezca en `true` para deshabilitar todas las indicaciones educativas |\n| `DISABLE_RESOURCES` | `false` | Establezca como `true` para deshabilitar todos los recursos (BRC, registro de cambios) |\n| `DISABLE_TOOLS` | `false` | Establezca en `true` para deshabilitar todas las herramientas |\n\n### Configuración específica de la herramienta\n\n| Variable de entorno | Por defecto | Descripción |\n| ------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `DISABLE_WALLET_TOOLS` | `false` | Establezca en `true` para deshabilitar las herramientas de billetera de Bitcoin |\n| `DISABLE_MNEE_TOOLS` | `false` | Establezca en `true` para deshabilitar las herramientas de token MNEE |\n| `DISABLE_BSV_TOOLS` | `false` | Establezca en `true` para deshabilitar las herramientas de blockchain de BSV |\n| `DISABLE_ORDINALS_TOOLS` | `false` | Establezca en `true` para deshabilitar las herramientas ordinales/NFT |\n| `DISABLE_UTILS_TOOLS` | `false` | Establezca en `true` para deshabilitar las herramientas de utilidad |\n| `IDENTITY_KEY_WIF` | `not set` | WIF opcional para clave de identidad; si se configura, las inscripciones de ordinales se firmarán con el protocolo sigma para autenticación, curación y web de confianza. |\n| `DISABLE_BROADCASTING` | `false` | Establezca en `true` para deshabilitar la transmisión de transacciones; en su lugar, devuelve el hexadecimal de la transacción sin procesar: útil para probar y revisar la transacción antes de la transmisión |\n\n### Ejemplos\n\nEjecute únicamente con recursos y estímulos educativos, sin herramientas:\n\n```bash\nDISABLE_TOOLS=true bunx bsv-mcp@latest\n```\n\nEjecute solo con herramientas BSV, sin billetera ni otra funcionalidad:\n\n```bash\nDISABLE_PROMPTS=true DISABLE_RESOURCES=true DISABLE_WALLET_TOOLS=true DISABLE_MNEE_TOOLS=true DISABLE_ORDINALS_TOOLS=true DISABLE_UTILS_TOOLS=true bunx bsv-mcp@latest\n```\n\nUtilice todas las herramientas excepto las operaciones de billetera:\n\n```bash\nDISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest\n```\n\nCrear transacciones sin difundirlas (modo de prueba):\n\n```bash\nDISABLE_BROADCASTING=true bunx bsv-mcp@latest\n```\n\n## Solución de problemas\n\nSi tiene problemas con el servidor BSV MCP:\n\n### Problemas de conexión\n\n1. Asegúrese de que Bun o Node.js esté instalado en su sistema\n2. Verifique que su clave privada WIF esté configurada correctamente en el entorno\n3. Compruebe que su cliente sea compatible con MCP y esté configurado correctamente\n4. Busque mensajes de error en la salida de la consola del cliente\n\n### Manteniendo a Bun actualizado\n\nEs importante mantener Bun actualizado a la última versión para garantizar la compatibilidad:\n\n```bash\n# Update Bun to the latest version\nbun upgrade\n```\n\nPara verificar su versión actual de Bun:\n\n```bash\nbun --version\n```\n\n### Registro y depuración\n\nPara Claude for Desktop, consulte los registros en:\n\n```bash\n# macOS/Linux\ntail -n 20 -f ~/Library/Logs/Claude/mcp*.log\n\n# Windows\ntype %APPDATA%\\Claude\\Logs\\mcp*.log\n```\n\nPara Cursor, verifique los registros de MCP de Cursor en Configuración → Extensiones → Protocolo de contexto de modelo.\n\n## Actualizaciones recientes\n\n* **Control de transmisión de transacciones** : se agregó la variable de entorno `DISABLE_BROADCASTING` para evitar que las transacciones se transmitan a la red\n* **Blockchain Explorer** : Se agregó la herramienta `bsv_explore` para el acceso a la API de WhatsOnChain con compatibilidad con mainnet/testnet\n* **Herramientas unificadas** : `wallet_encrypt` y `wallet_decrypt` se fusionaron en una única herramienta `wallet_encryption`\n* **Mercado mejorado** : compatibilidad con NFT y tokens BSV-20/21 en listados, ventas y compras\n* **Rendimiento** : Se agregó almacenamiento en caché de precios y se optimizó la estructura del punto final de la API.\n* **Validación mejorada** : mejor manejo de errores para claves privadas y parámetros\n\n## Explorador de cadenas de bloques de Bitcoin SV\n\nLa herramienta `bsv_explore` proporciona acceso completo a la blockchain de Bitcoin SV a través de la API WhatsOnChain. Esta potente herramienta de exploración permite consultar diversos aspectos de la blockchain, incluyendo datos de la cadena, bloques, transacciones e información de direcciones.\n\n### Puntos finales disponibles\n\nLa herramienta admite las siguientes categorías de puntos finales y puntos finales específicos:\n\n#### Datos de la cadena\n\n| Punto final | Descripción | Parámetros requeridos | Ejemplo de respuesta |\n| -------------------- | -------------------------------------------------------------- | --------------------- | ----------------------------------------------------------------------------------- |\n| `chain_info` | Estadísticas de red, dificultad y trabajo en cadena | Ninguno | `{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}` |\n| `chain_tips` | Consejos actuales sobre la cadena, incluidas alturas y estados | Ninguno | `[{\"height\":826458,\"hash\":\"000000000000...\",\"branchlen\":0,\"status\":\"active\"}]` |\n| `circulating_supply` | Suministro circulante actual de BSV | Ninguno | `{\"bsv\":21000000}` |\n| `peer_info` | Estadísticas de pares conectados | Ninguno | `[{\"addr\":\"1.2.3.4:8333\",\"services\":\"000000000000...\",\"lastsend\":1621234567}]` |\n\n#### Bloquear datos\n\n| Punto final | Descripción | Parámetros requeridos | Ejemplo de respuesta |\n| --------------------- | --------------------------------------------------------------------- | ------------------------------------ | -------------------------------------------------------------------------- |\n| `block_by_hash` | Datos de bloque completos mediante hash | `blockHash` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `block_by_height` | Datos de bloque completos por altura | `blockHeight` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `tag_count_by_height` | Estadísticas sobre el recuento de etiquetas para un bloque específico | `blockHeight` | `{\"tags\":{\"amp\":3,\"bitkey\":5,\"metanet\":12,\"planaria\":7,\"b\":120}}` |\n| `block_headers` | Recupera los últimos 10 encabezados de bloque | Ninguno | `[{\"hash\":\"000000000000...\",\"height\":826458,\"version\":536870912,...},...]` |\n| `block_pages` | Recupera páginas de ID de transacciones para bloques grandes | `blockHash` , opcional: `pageNumber` | `[\"tx1hash\",\"tx2hash\",\"tx3hash\",...]` |\n\n#### Datos estadísticos\n\n| Punto final | Descripción | Parámetros requeridos | Ejemplo de respuesta |\n| ----------------------- | --------------------------------------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------- |\n| `block_stats_by_height` | Estadísticas de bloque para una altura específica | `blockHeight` | `{\"size\":123456,\"txCount\":512,\"outputTotal\":54.12345678,\"outputTotalUsd\":2345.67,...}` |\n| `block_miner_stats` | Estadísticas de minería de bloques durante un período de tiempo | opcional: `days` (predeterminado 7) | `{\"blocks\":{\"miner1\":412,\"miner2\":208,...},\"total\":1008}` |\n| `miner_summary_stats` | Resumen de las estadísticas mineras | opcional: `days` (predeterminado 7) | `{\"totalBlocks\":1008,\"totalFees\":1.23456789,\"totalFeesUsd\":53.67,...}` |\n\n#### Datos de la transacción\n\n| Punto final | Descripción | Parámetros requeridos | Ejemplo de respuesta |\n| ----------------- | ------------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------ |\n| `tx_by_hash` | Datos detallados de las transacciones | `txHash` | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,...}` |\n| `tx_raw` | Datos hexadecimales de transacciones sin procesar | `txHash` | `\"01000000012345abcdef...\"` |\n| `tx_receipt` | Recibo de transacción | `txHash` | `{\"blockHash\":\"000000000000...\",\"blockHeight\":800000,\"confirmations\":26458}` |\n| `bulk_tx_details` | Recuperar múltiples transacciones en una sola solicitud | `txids` (matriz) | `[{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,...}, {\"txid\":\"b2c3d4e5f6a7...\",\"version\":1,...}]` |\n\n#### Datos de dirección\n\n| Punto final | Descripción | Parámetros requeridos | Ejemplo de respuesta |\n| ----------------- | ------------------------------------------ | ----------------------------- | --------------------------------------------------------------- |\n| `address_history` | Historial de transacciones de la dirección | `address` , opcional: `limit` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"height\":800000},...]` |\n| `address_utxos` | Salidas no utilizadas para la dirección | `address` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"tx_pos\":0,\"value\":100000},...]` |\n\n#### Red\n\n| Punto final | Descripción | Parámetros requeridos | Ejemplo de respuesta |\n| ----------- | --------------------------------- | --------------------- | --------------------- |\n| `health` | Comprobación del estado de la API | Ninguno | `{\"status\":\"synced\"}` |\n\n### Ejemplos de uso\n\nLa herramienta `bsv_explore` se puede utilizar con indicaciones en lenguaje natural como:\n\n```\n\"Get the current Bitcoin SV blockchain information\"\n\"Show me block #800000 details\"\n\"Get tag count statistics for block #800000\"\n\"Fetch transaction history for address 1ExampleBsvAddressXXXXXXXX\"\n\"Get unspent outputs for my wallet address\"\n\"Check transaction details for txid a1b2c3d4e5f6...\"\n\"What is the current BSV circulating supply?\"\n\"Show me the latest block headers\"\n\"Get transaction IDs for page 2 of a large block\"\n\"Show me block statistics for height 800000\"\n\"What are the mining statistics for the last 14 days?\"\n\"Get a summary of mining activity over the past 30 days\"\n\"Retrieve details for multiple transactions in a single query\"\n```\n\nBajo el capó, la herramienta acepta parámetros para especificar qué datos recuperar:\n\n* `endpoint` : el punto final específico de WhatsOnChain para consultar (por ejemplo, `chain_info` , `tx_by_hash` )\n* `network` : La red BSV a utilizar ( `main` o `test` )\n* Parámetros adicionales según lo requiera el punto final específico:\n * `blockHash` : para puntos finales block\\_by\\_hash y block\\_pages\n * `blockHeight` : para los puntos finales block\\_by\\_height, tag\\_count\\_by\\_height y block\\_stats\\_by\\_height\n * `pageNumber` : Para el punto final block\\_pages (paginación)\n * `days` : para los puntos finales block\\_miner\\_stats y miner\\_summary\\_stats (el valor predeterminado es 7)\n * `txHash` : para puntos finales relacionados con transacciones (tx\\_by\\_hash, tx\\_raw, tx\\_receipt)\n * `txids` : para el punto final bulk\\_tx\\_details (matriz de ID de transacción)\n * `address` : para puntos finales relacionados con la dirección\n * `limit` : límite de paginación opcional para address\\_history\n\n### Opciones de red\n\nLa herramienta es compatible tanto con la red principal como con la red de prueba:\n\n* `main` : red principal de Bitcoin SV (predeterminada)\n* `test` : red de pruebas de Bitcoin SV\n\n# Desarrollo\n\n## Configuración del proyecto\n\nSi quieres contribuir al proyecto o ejecutarlo localmente:\n\n1. Clonar el repositorio:\n\n ```bash\n git clone https://github.com/b-open-io/bsv-mcp.git\n cd bsv-mcp\n ```\n\n2. Instalar dependencias:\n\n ```bash\n bun install\n # or with npm\n npm install\n ```\n\n## Ejecución del servidor\n\n```bash\nbun run index.ts\n# or with npm\nnpm run start\n```\n\n### Ejecución de pruebas\n\n```bash\nbun test\n# or with npm\nnpm test\n```\n\n## Licencia\n\nEste proyecto está licenciado bajo la licencia MIT: consulte el archivo [de LICENCIA](LICENSE) para obtener más detalles.","Spanish","es-ES",{"_29":49,"_37":53,"_39":54},{"_31":50,"_33":51,"_35":52},"AI アシスタントがウォレット操作、序数 (NFT)、およびさまざまなブロックチェーンユーティリティを通じて BSV ブロックチェーンと対話できるようにする、モデルコンテキストプロトコル用の Bitcoin SV ツールのコレクション。","Bitcoin SV MCP サーバー","# Bitcoin SV MCP サーバー\n\n[![鍛冶屋のバッジ](https://smithery.ai/badge/@b-open-io/bsv-mcp)](https://smithery.ai/server/@b-open-io/bsv-mcp)\n\n> **⚠️ 注意: 実験作業進行中**\\\n> このプロジェクトはまだ初期段階の実験段階です。機能は変更される可能性があり、APIはまだ安定していません。貢献、フィードバック、バグ報告を歓迎します！お気軽に問題を報告したり、プルリクエストを送信してください。\n\nモデルコンテキストプロトコル（MCP）フレームワーク用のBitcoin SV（BSV）ツールのコレクション。このライブラリは、BSVブロックチェーンとの連携に必要なウォレット、序数、ユーティリティ関数を提供します。\n\n## インストールとセットアップ\n\n### パンを使用する（オプションですが推奨）\n\nこのプロジェクトは、高速なJavaScriptランタイム兼パッケージマネージャーである[Bun](https://bun.sh/)を使用して構築されています。最高のパフォーマンスを得るにはBunの使用が推奨されますが、BunはNode.jsとの下位互換性を持つように設計されているため、サーバーはNode.jsとnpmでも実行できます。\n\n#### Bunのインストール\n\n**macOS (Homebrew を使用):**\n\n```bash\nbrew install oven-sh/bun/bun\n```\n\n**macOS/Linux/WSL (インストーラースクリプトを使用):**\n\n```bash\ncurl -fsSL https://bun.sh/install | bash\n```\n\n**Windows:** Windows ユーザーは、Bun を実行するために WSL (Windows Subsystem for Linux) または Docker を使用する必要があります。\n\nNode.js と npm も動作しますが、同じパフォーマンス上の利点が得られない可能性があります。\n\n## MCPクライアントへの接続\n\nこのサーバーは[モデルコンテキストプロトコル](https://modelcontextprotocol.io/)（MCP）を実装しており、AIアシスタントがBitcoin SVの機能を利用できるようにします。このサーバーは、MCP対応の様々なクライアントに接続できます。\n\n![MCP 構成例](docs/images/mcp-config-example.png)\n\n> **注:** `PRIVATE_KEY_WIF`環境変数はオプションになりました。この環境変数を指定しないと、サーバーは教育リソースとウォレット以外のツールが利用可能な制限モードで動作します。ウォレットとMNEEトークンの操作には有効な秘密鍵が必要です。また、 `IDENTITY_KEY_WIF`環境変数を設定することで、認証、キュレーション、信頼の輪のための序数表記のシグマプロトコル署名を有効にすることもできます。\n\n### カーソル\n\n[Cursor](https://cursor.sh/)で BSV MCP サーバーを使用するには:\n\n1. まだインストールしていない場合は、Cursorをインストールしてください。\n2. カーソルを開き、設定→拡張機能→モデルコンテキストプロトコルに移動します。\n3. 「新しいグローバルMCPサーバーを追加」をクリックします\n4. 次の構成を JSON 形式で入力します。\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bunx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n5. ``を実際の秘密鍵 WIF に置き換えてください（安全な場所に保管してください！）。WIF をお持ちでない場合は、今のところ省略できますが、ウォレットを必要とするツールは使用できなくなります。 ``もオプションです。これは、提供された ID キーを使用して、Sigma プロトコルで 1Sat Ordinals に署名します。\n\n6. 「保存」をクリック\n\nBSV ツールは、「Bitcoin SV」名前空間の Cursor の AI アシスタントで利用できるようになります。\n\n#### npmユーザー向けの代替手段\n\nBun の代わりに npm を使用する場合:\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"npx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n### デスクトップ版クロード\n\nこのサーバーをClaude for Desktopに接続するには:\n\n1. [Claude for Desktop](https://claude.ai/desktop)を開き、Claude > 設定 > 開発者に移動します。\n2. 「設定の編集」をクリックします。\n\nClaude の設定 JSON ファイルを、お好きなテキストエディタで開きます。CLI から実行する場合は、以下の手順を実行してください。\n\n```bash\n# macOS/Linux\ncode ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n\n# Windows\ncode %APPDATA%\\Claude\\claude_desktop_config.json\n```\n\n3. BSV MCP サーバーを設定に追加します。\n\n ```json\n {\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bun\",\n \"args\": [\n \"run\", \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n }\n ```\n\n4. ``を実際の秘密鍵 WIF に置き換えます。\n\n5. ファイルを保存し、Claude for Desktopを再起動します。\n\n6. Claude for Desktopのツールアイコン（ハンマー）をクリックするとBSVツールが表示されます。\n\n#### npm ユーザー向けの代替手段 (Claude)\n\nBun の代わりに npm を使用する場合は、「command」フィールドを「npx」に置き換えます。\n\n## 利用可能なツール\n\nツールキットはいくつかのカテゴリに分類されています。\n\n### ウォレットツール\n\nウォレットツールはBSVウォレットのコア機能を提供します。\n\n| ツール名 | 説明 | 出力例 |\n| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |\n| `wallet_getPublicKey` | 指定されたプロトコルとキーIDの公開キーを取得します | `{\"publicKey\":\"032d0c73eb9270e9e009fd1f9dd77e19cf764fbad5f799560c4e8fd414e40d6fc2\"}` |\n| `wallet_createSignature` | 提供されたデータの暗号署名を作成する | `{\"signature\":[144,124,85,193,226,45,140,249,9,177,11,167,33,215,209,38,...]}` |\n| `wallet_verifySignature` | 提供されたデータに対して暗号署名を検証する | `{\"isValid\":true}` |\n| `wallet_encryption` | ウォレットの暗号鍵を使用してデータを暗号化および復号化するための複合ツール。**例：** 1. テキストを暗号化： `\"Encrypt this message: Hello World\"` 2. データを復号化： `\"Decrypt this data that was previously encrypted for me\"` | 暗号化: `{\"ciphertext\":[89,32,155,38,125,22,49,226,26,...]}`復号化: `{\"plaintext\":\"hello world\"}` |\n| `wallet_getAddress` | 現在のウォレットのBSVアドレスまたは派生パスを返します | `{\"address\":\"1ExampleBsvAddressXXXXXXXXXXXXXXXXX\",\"status\":\"ok\"}` |\n| `wallet_sendToAddress` | 指定されたアドレスにBSVを送信します（BSVまたはUSDの金額をサポート） | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"satoshis\":1000000}` |\n| `wallet_purchaseListing` | マーケットプレイスのリストからNFTまたはBSV-20/BSV-21トークンを購入する | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"type\":\"nft\",\"origin\":\"abcdef123456...\"}` |\n| `wallet_createOrdinals` | BSVブロックチェーン上に序数を作成して刻み込む | `{\"txid\":\"a1b2c3d4e5f6...\",\"inscriptionAddress\":\"1ExampleAddress...\",\"contentType\":\"image/png\"}` |\n\n### BSVツール\n\nBSVブロックチェーンおよびネットワークとやり取りするためのツール:\n\n| ツール名 | 説明 | 出力例 |\n| ----------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |\n| `bsv_getPrice` | 取引所APIから現在のBSV価格を取得します | `Current BSV price: $38.75 USD` |\n| `bsv_decodeTransaction` | BSVトランザクションをデコードし、詳細情報を返します | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,\"inputs\":[...],\"outputs\":[...]}` |\n| `bsv_explore` | WhatsOnChain APIエンドポイントにアクセスできる包括的なブロックチェーンエクスプローラーツール | `{\"chain_info\":{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}}` |\n\n### 序数ツール\n\nBSVで序数（NFT）を操作するためのツール：\n\n| ツール名 | 説明 | 出力例 |\n| ------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |\n| `ordinals_getInscription` | 特定の碑文に関する詳細情報を取得します | `{\"id\":\"a1b2c3d4e5f6...\",\"origin\":\"a1b2c3d4e5f6...\",\"contentType\":\"image/png\",\"content\":\"iVBORw0KGgoAAA...\"}` |\n| `ordinals_searchInscriptions` | さまざまな基準に基づいて碑文を検索する | `{\"results\":[{\"id\":\"a1b2c3...\",\"contentType\":\"image/png\",\"owner\":\"1Example...\"},...]}` |\n| `ordinals_marketListings` | 統一されたインターフェースでNFT、BSV-20、BSV-21トークンの市場リストを取得します | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":9990000,\"tick\":\"PEPE\",\"listing\":true},...]}` |\n| `ordinals_marketSales` | BSV-20およびBSV-21トークンの市場販売に関する情報を取得します | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":34710050,\"tick\":\"$BTC\",\"sale\":true},...]}` |\n| `ordinals_getTokenByIdOrTicker` | IDで特定のBSV20トークンの詳細を取得します | `{\"tick\":\"PEPE\",\"max\":\"21000000\",\"lim\":\"1000\",\"dec\":\"2\"}` |\n\n### ユーティリティツール\n\n汎用ユーティリティ関数:\n\n| ツール名 | 説明 | 出力例 |\n| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |\n| `utils_convertData` | 異なるエンコード形式 (utf8、16 進数、base64、バイナリ) 間でデータを変換します。**パラメータ:** - `data` (必須): 変換する文字列`from` (必須): ソースエンコード形式 (utf8、16 進数、base64、またはバイナリ) - `to` (必須): ターゲットエンコード形式 (utf8、16 進数、base64、またはバイナリ)**例:** - UTF-8 から 16 進数: `{\"data\": \"hello world\", \"from\": \"utf8\", \"to\": \"hex\"}` → `68656c6c6f20776f726c64` - UTF-8 から base64: `{\"data\": \"Hello World\", \"from\": \"utf8\", \"to\": \"base64\"}` → `SGVsbG8gV29ybGQ=` - base64 から UTF-8: `{\"data\": \"SGVsbG8gV29ybGQ=\", \"from\": \"base64\", \"to\": \"utf8\"}` → `Hello World` - 16 進数から base64: `{\"data\": \"68656c6c6f20776f726c64\", \"from\": \"hex\", \"to\": \"base64\"}` → `aGVsbG8gd29ybGQ=`**注:** - すべてのパラメータは必須です - ツールは変換されたデータを文字列として返します - バイナリ変換の場合、データはバイト値の配列として表されます | `\"SGVsbG8gV29ybGQ=\"` （UTF-8の「Hello World」をbase64に変換） |\n\n### MNEEツール\n\nMNEE トークンを操作するためのツール:\n\n| ツール名 | 説明 | 出力例 |\n| ----------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `mnee_getBalance` | ウォレットの現在のMNEEトークン残高を取得します | `{\"balance\": {\"amount\": 2900, \"decimalAmount\": 0.029}}` |\n| `mnee_sendMnee` | MNEEトークンを指定のアドレスに送信します。MNEEとUSDの両方の金額をサポートします。 | `{\"success\": true, \"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"rawtx\": \"0100000002a0be40d8942015f1...\", \"mneeAmount\": 0.01, \"usdAmount\": \"$0.01\", \"recipient\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\"}` |\n| `mnee_parseTx` | MNEE取引を解析して、その操作と金額に関する詳細情報を取得します。金額はすべて小数点以下5桁の原子単位で表されます（例：1000原子単位 = 0.01 MNEE）。 | `{\"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"environment\": \"production\", \"type\": \"transfer\", \"inputs\": [{\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 2900}], \"outputs\": [{\"address\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\", \"amount\": 1000}, {\"address\": \"19Vq2TV8aVhFNLQkhDMdnEQ7zT96x6F3PK\", \"amount\": 100}, {\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 1800}]}` |\n\n## MCP でのツールの使用\n\n接続すると、AIアシスタントを介して自然言語でBitcoin SVと対話できるようになります。プロンプトの例を以下に示します。\n\n### ウォレット操作\n\n* 「Bitcoin SVアドレスを取得する」\n* 「0.01 BSVを1ExampleBsvAddressXXXXXXXXXXXXXXXXXXに送金する」\n* 「1ExampleBsvAddressXXXXXXXXXXXXXXXXXXに5米ドル相当のBSVを送信してください」\n* 「0.01 MNEEを1ExampleBsvAddressXXXXXXXXXXXXXXXXXXに送金する」\n* 「MNEE残高を確認する」\n* 「このMNEEトランザクションを解析する: txid」\n* 「ウォレットのキーを使用してこのメッセージを暗号化する」\n* 「以前暗号化されたこのデータを復号化してください」\n* 「このNFTリストを購入: txid\\_vout」\n* 「このBSV-20トークンリストを購入: txid\\_vout」\n\n### 序数（NFT）\n\n* 「アウトポイント6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325\\_0のNFTに関する情報を表示してください」\n* 「Pixel Zoide NFTを検索」\n* 「BSV NFTの現在のマーケットプレイスリストを表示」\n* 「ティッカーPEPEのBSV-20トークンリストを表示」\n* 「最近のBSV-20トークンセール情報を入手」\n\n### ブロックチェーン運用\n\n* 「現在のBSVの価格はいくらですか？」\n* 「このBSVトランザクションをデコードします: (トランザクションの16進数またはID)」\n* 「最新のビットコインSVチェーン情報を入手する」\n* 「高さ800000のブロックの詳細を表示」\n* 「アドレス 1ExampleBsvAddressXXXX の取引履歴を調べる」\n* 「ウォレットアドレスの未使用出力（UTXO）を確認する」\n* 「ハッシュ a1b2c3d4e5f6 のトランザクションの詳細を取得します...」\n\n### データ変換\n\n* 「『Hello World』をUTF-8から16進形式に変換する」\n\n## MCP プロンプトとリソース\n\nBSV MCPサーバーは、Bitcoin SVテクノロジーに関する詳細な情報とコンテキストを提供する専用のプロンプトとリソースを公開しています。AIモデルはこれらにアクセスすることで、理解度と能力を向上させることができます。\n\n### 利用可能なプロンプト\n\nサーバーは、MCP プロトコルを介して直接アクセスできる次の教育プロンプトを提供します。\n\n#### 序数プロンプト\n\n* **識別子**： `bitcoin_sv_ordinals`\n* **説明**: Bitcoin SV 序数に関する包括的な情報（それが何であるか、どのように機能するか、どのように使用するかなど）。\n* **使用方法**: この情報にアクセスするには、アシスタントに「Bitcoin SV ordinals」または「1Sat Ordinals」について尋ねます。\n\n#### BSV SDK プロンプト\n\nBitcoin SV SDK に関する詳細情報を提供するプロンプトのコレクション:\n\n* **概要**\n\n * **識別子**: `bitcoin_sv_sdk_overview`\n * **説明**: Bitcoin SV SDK の目的と主なコンポーネントを含む概要。\n * **使用方法**:「BSV SDK について教えてください」または「Bitcoin SV SDK とは何ですか?」\n\n* **ウォレット操作**\n\n * **識別子**: `bitcoin_sv_sdk_wallet`\n * **説明**: BSV SDK でのウォレット操作に関する情報。\n * **使用方法**: 「BSV SDK ではウォレット操作はどのように機能しますか?」\n\n* **取引の構築**\n\n * **識別子**: `bitcoin_sv_sdk_transaction`\n * **説明**: トランザクションの作成と操作に関する詳細。\n * **使用方法**:「BSV SDK トランザクションの構築について説明します」または「BSV SDK を使用してトランザクションを作成するにはどうすればよいですか?」\n\n* **認証**\n\n * **識別子**: `bitcoin_sv_sdk_auth`\n * **説明**: BSV SDK の認証および ID プロトコル。\n * **使用方法**:「BSV SDK では認証はどのように機能しますか?」\n\n* **暗号化**\n\n * **識別子**: `bitcoin_sv_sdk_cryptography`\n * **説明**: 署名、暗号化、検証機能。\n * **使用方法**:「BSV SDK の暗号化機能の説明」\n\n* **スクリプト**\n\n * **識別子**: `bitcoin_sv_sdk_script`\n * **説明**: Bitcoin のスクリプトと契約機能。\n * **使用方法**: 「BSV SDK を使用して Bitcoin スクリプトを操作するにはどうすればよいですか?」\n\n* **プリミティブ**\n\n * **識別子**: `bitcoin_sv_sdk_primitives`\n * **説明**: BSV SDK のコアデータ型と構造。\n * **使用法**:「BSV SDK ではどのようなプリミティブが利用できますか?」\n\n### 利用可能なリソース\n\nサーバーは、Bitcoin Request for Comments (BRC) の仕様とドキュメントへのアクセスも提供します。\n\n#### 変更ログリソース\n\n* **識別子**: `bsv-mcp-changelog`\n* **説明**: BSV MCP サーバーのバージョン履歴と変更ログ。\n* **使用方法**: 「BSV MCP の変更ログを表示してください」または「最新バージョンの新機能は何ですか?」\n\n#### BRCリソース\n\n* **BRCの概要**\n\n * **識別子**: `brcs_readme`\n * **説明**: BRC リポジトリ内のすべての Bitcoin SV プロトコル仕様の概要。\n * **使用方法**: 「Bitcoin SV BRC の概要を表示」\n\n* **BRCの概要**\n\n * **識別子**: `brcs_summary`\n * **説明**: すべての Bitcoin SV BRC の目次。\n * **使用方法**：「Bitcoin SV BRCの概要を教えてください」\n\n* **具体的なBRC仕様**\n\n * **識別子**: `brc_spec`\n * **説明**: カテゴリと番号で特定の BRC 仕様にアクセスします。\n * **使用法**: 「取引エンベロープの BRC 8 を表示してください」または「BRC 1 は何を指定しますか?」\n\n#### BRCカテゴリー\n\nBRC 仕様は次のカテゴリに分類されます。\n\n* 財布\n* 取引\n* スクリプト\n* トークン\n* オーバーレイ\n* 支払い\n* ピアツーピア\n* 鍵導出\n* アウトポイント\n* 意見\n* ステートマシン\n* アプリ\n\n### プロンプトとリソースの使用\n\nAIモデルはこれらのプロンプトとリソースを使用して、Bitcoin SVテクノロジーに関するより正確で詳細な回答を提供できます。ユーザーは以下のことができます。\n\n1. **特定のトピックについて質問する**:「Bitcoin SV のオーディナルについて教えてください」または「BSV SDK のトランザクション構築について説明してください」\n2. **具体的な BRC の詳細をリクエストします**。「BRC 8 では何が規定されていますか？」または「トランザクション作成時の BRC を表示してください」\n3. **一般的な概要を確認する**：「BSV SDK とは何ですか？」または「すべての BRC の概要を表示してください」\n\nこれらのプロンプトとリソースにより、AI の知識ベースが強化され、複雑な Bitcoin SV トピックに対しても、より技術的で正確な応答が可能になります。\n\n## MCPの仕組み\n\nMCP 対応の AI アシスタントと対話する場合:\n\n1. AIがあなたのリクエストを分析し、どのツールを使用するかを決定します\n2. 承認されると、適切なBSV MCPツールが呼び出されます。\n3. サーバーはビットコインSVブロックチェーン上で要求された操作を実行する\n4. 結果はAIアシスタントに返されます\n5. アシスタントは自然な会話形式で情報を提示します\n\n## カスタマイズオプション\n\nBSV MCP サーバーは、環境変数を使用して特定のコンポーネントを有効または無効にすることでカスタマイズできます。\n\n### コンポーネント構成\n\n| 環境変数 | デフォルト | 説明 |\n| ------------------- | ------- | ----------------------------------------- |\n| `DISABLE_PROMPTS` | `false` | すべての教育プロンプトを無効にするには、 `true`に設定します |\n| `DISABLE_RESOURCES` | `false` | すべてのリソース（BRC、変更ログ）を無効にするには、 `true`に設定します。 |\n| `DISABLE_TOOLS` | `false` | すべてのツールを無効にするには`true`に設定します |\n\n### ツール固有の構成\n\n| 環境変数 | デフォルト | 説明 |\n| ------------------------ | --------- | ------------------------------------------------------------------------------------------------- |\n| `DISABLE_WALLET_TOOLS` | `false` | Bitcoinウォレットツールを無効にするには`true`に設定します |\n| `DISABLE_MNEE_TOOLS` | `false` | MNEEトークンツールを無効にするには`true`に設定します |\n| `DISABLE_BSV_TOOLS` | `false` | BSVブロックチェーンツールを無効にするには`true`に設定してください |\n| `DISABLE_ORDINALS_TOOLS` | `false` | 序数/NFTツールを無効にするには`true`に設定してください |\n| `DISABLE_UTILS_TOOLS` | `false` | ユーティリティツールを無効にするには`true`に設定します |\n| `IDENTITY_KEY_WIF` | `not set` | 識別キー用のオプションの WIF。設定されている場合、序数の刻印は認証、キュレーション、および信頼の Web のためにシグマプロトコルで署名されます。 |\n| `DISABLE_BROADCASTING` | `false` | `true`に設定すると、トランザクションのブロードキャストが無効になります。代わりに、生のトランザクションの16進数を返します。ブロードキャスト前のテストやトランザクションの確認に役立ちます。 |\n\n### 例\n\nツールを使わず、教育リソースとプロンプトのみで実行します。\n\n```bash\nDISABLE_TOOLS=true bunx bsv-mcp@latest\n```\n\nウォレットやその他の機能なしで、BSV ツールのみで実行します。\n\n```bash\nDISABLE_PROMPTS=true DISABLE_RESOURCES=true DISABLE_WALLET_TOOLS=true DISABLE_MNEE_TOOLS=true DISABLE_ORDINALS_TOOLS=true DISABLE_UTILS_TOOLS=true bunx bsv-mcp@latest\n```\n\nウォレット操作以外のすべてのツールを使用します。\n\n```bash\nDISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest\n```\n\nブロードキャストせずにトランザクションを作成する (ドライランモード):\n\n```bash\nDISABLE_BROADCASTING=true bunx bsv-mcp@latest\n```\n\n## トラブルシューティング\n\nBSV MCP サーバーに問題がある場合:\n\n### 接続の問題\n\n1. システムにBunまたはNode.jsがインストールされていることを確認してください\n2. WIF秘密鍵が環境に正しく設定されていることを確認します\n3. クライアントがMCPをサポートし、適切に構成されていることを確認してください。\n4. クライアントのコンソール出力でエラーメッセージを探します\n\n### Bunを最新の状態に保つ\n\n互換性を確保するために、Bun を最新バージョンに更新しておくことが重要です。\n\n```bash\n# Update Bun to the latest version\nbun upgrade\n```\n\n現在の Bun バージョンを確認するには:\n\n```bash\nbun --version\n```\n\n### ログ記録とデバッグ\n\nClaude for Desktop の場合は、次のログを確認してください。\n\n```bash\n# macOS/Linux\ntail -n 20 -f ~/Library/Logs/Claude/mcp*.log\n\n# Windows\ntype %APPDATA%\\Claude\\Logs\\mcp*.log\n```\n\nカーソルの場合は、\\[設定] → \\[拡張機能] → \\[モデルコンテキストプロトコル] でカーソル MCP ログを確認します。\n\n## 最近の更新\n\n* **トランザクションブロードキャスト制御**: トランザクションがネットワークにブロードキャストされるのを防ぐための`DISABLE_BROADCASTING`環境変数を追加しました\n* **ブロックチェーンエクスプローラー**：メインネット/テストネットをサポートするWhatsOnChain APIアクセス用の`bsv_explore`ツールを追加しました\n* **統合ツール**: `wallet_encrypt` / `wallet_decrypt`単一の`wallet_encryption`ツールに統合しました\n* **強化されたマーケットプレイス**：出品、販売、購入におけるNFT、BSV-20/21トークンのサポート\n* **パフォーマンス**: 価格キャッシュの追加とAPIエンドポイント構造の最適化\n* **検証の改善**：秘密鍵とパラメータのエラー処理の改善\n\n## Bitcoin SV ブロックチェーンエクスプローラー\n\n`bsv_explore`ツールは、WhatsOnChain APIを介してBitcoin SVブロックチェーンへの包括的なアクセスを提供します。この強力なエクスプローラーツールを使用すると、チェーンデータ、ブロック、トランザクション、アドレス情報など、ブロックチェーンのさまざまな側面を照会できます。\n\n### 利用可能なエンドポイント\n\nこのツールは、次のエンドポイントカテゴリと特定のエンドポイントをサポートしています。\n\n#### チェーンデータ\n\n| 終点 | 説明 | 必須パラメータ | 回答例 |\n| -------------------- | -------------------- | ------- | ----------------------------------------------------------------------------------- |\n| `chain_info` | ネットワーク統計、難易度、チェーンワーク | なし | `{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}` |\n| `chain_tips` | 高さや状態を含む現在のチェーンのヒント | なし | `[{\"height\":826458,\"hash\":\"000000000000...\",\"branchlen\":0,\"status\":\"active\"}]` |\n| `circulating_supply` | 現在のBSV流通供給量 | なし | `{\"bsv\":21000000}` |\n| `peer_info` | 接続されたピアの統計 | なし | `[{\"addr\":\"1.2.3.4:8333\",\"services\":\"000000000000...\",\"lastsend\":1621234567}]` |\n\n#### ブロックデータ\n\n| 終点 | 説明 | 必須パラメータ | 回答例 |\n| --------------------- | ---------------------------- | -------------------------------- | -------------------------------------------------------------------------- |\n| `block_by_hash` | ハッシュによるブロックデータの完全化 | `blockHash` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `block_by_height` | 高さでブロックデータを完了する | `blockHeight` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `tag_count_by_height` | 特定のブロックのタグ数の統計 | `blockHeight` | `{\"tags\":{\"amp\":3,\"bitkey\":5,\"metanet\":12,\"planaria\":7,\"b\":120}}` |\n| `block_headers` | 最後の10個のブロックヘッダーを取得します | なし | `[{\"hash\":\"000000000000...\",\"height\":826458,\"version\":536870912,...},...]` |\n| `block_pages` | 大きなブロックのトランザクションIDのページを取得します | `blockHash` 、オプション: `pageNumber` | `[\"tx1hash\",\"tx2hash\",\"tx3hash\",...]` |\n\n#### 統計データ\n\n| 終点 | 説明 | 必須パラメータ | 回答例 |\n| ----------------------- | ---------------- | ----------------------- | -------------------------------------------------------------------------------------- |\n| `block_stats_by_height` | 特定の高さのブロック統計 | `blockHeight` | `{\"size\":123456,\"txCount\":512,\"outputTotal\":54.12345678,\"outputTotalUsd\":2345.67,...}` |\n| `block_miner_stats` | 一定期間のブロックマイニング統計 | オプション: `days` （デフォルトは7） | `{\"blocks\":{\"miner1\":412,\"miner2\":208,...},\"total\":1008}` |\n| `miner_summary_stats` | 鉱業統計の概要 | オプション: `days` （デフォルトは7） | `{\"totalBlocks\":1008,\"totalFees\":1.23456789,\"totalFeesUsd\":53.67,...}` |\n\n#### 取引データ\n\n| 終点 | 説明 | 必須パラメータ | 回答例 |\n| ----------------- | ------------------------- | ------------ | ------------------------------------------------------------------------------------------ |\n| `tx_by_hash` | 詳細な取引データ | `txHash` | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,...}` |\n| `tx_raw` | 生のトランザクション16進データ | `txHash` | `\"01000000012345abcdef...\"` |\n| `tx_receipt` | 取引領収書 | `txHash` | `{\"blockHash\":\"000000000000...\",\"blockHeight\":800000,\"confirmations\":26458}` |\n| `bulk_tx_details` | 1回のリクエストで複数のトランザクションを取得する | `txids` (配列) | `[{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,...}, {\"txid\":\"b2c3d4e5f6a7...\",\"version\":1,...}]` |\n\n#### 住所データ\n\n| 終点 | 説明 | 必須パラメータ | 回答例 |\n| ----------------- | ---------- | ------------------------- | --------------------------------------------------------------- |\n| `address_history` | 住所の取引履歴 | `address` 、オプション: `limit` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"height\":800000},...]` |\n| `address_utxos` | アドレスの未使用出力 | `address` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"tx_pos\":0,\"value\":100000},...]` |\n\n#### ネットワーク\n\n| 終点 | 説明 | 必須パラメータ | 回答例 |\n| -------- | ---------- | ------- | --------------------- |\n| `health` | APIヘルスチェック | なし | `{\"status\":\"synced\"}` |\n\n### 使用例\n\n`bsv_explore`ツールは、次のような自然言語プロンプトで使用できます。\n\n```\n\"Get the current Bitcoin SV blockchain information\"\n\"Show me block #800000 details\"\n\"Get tag count statistics for block #800000\"\n\"Fetch transaction history for address 1ExampleBsvAddressXXXXXXXX\"\n\"Get unspent outputs for my wallet address\"\n\"Check transaction details for txid a1b2c3d4e5f6...\"\n\"What is the current BSV circulating supply?\"\n\"Show me the latest block headers\"\n\"Get transaction IDs for page 2 of a large block\"\n\"Show me block statistics for height 800000\"\n\"What are the mining statistics for the last 14 days?\"\n\"Get a summary of mining activity over the past 30 days\"\n\"Retrieve details for multiple transactions in a single query\"\n```\n\n内部的には、ツールは取得するデータを指定するためのパラメータを受け入れます。\n\n* `endpoint` : クエリする特定の WhatsOnChain エンドポイント (例: `chain_info` 、 `tx_by_hash` )\n* `network` : 使用するBSVネットワーク（ `main`または`test` ）\n* 特定のエンドポイントに必要な追加パラメータ:\n * `blockHash` : block\\_by\\_hash および block\\_pages エンドポイント用\n * `blockHeight` : block\\_by\\_height、tag\\_count\\_by\\_height、block\\_stats\\_by\\_heightエンドポイントの場合\n * `pageNumber` : block\\_pagesエンドポイント（ページネーション）\n * `days` : block\\_miner\\_stats および miner\\_summary\\_stats エンドポイントの場合 (デフォルトは 7)\n * `txHash` : トランザクション関連のエンドポイント (tx\\_by\\_hash、tx\\_raw、tx\\_receipt)\n * `txids` : bulk\\_tx\\_detailsエンドポイント用（トランザクションIDの配列）\n * `address` : アドレス関連のエンドポイントの場合\n * `limit` : address\\_history のページ区切り制限（オプション）\n\n### ネットワークオプション\n\nこのツールはメインネットとテストネットの両方をサポートしています。\n\n* `main` : Bitcoin SV メインネット（デフォルト）\n* `test` ：Bitcoin SV テストネット\n\n# 発達\n\n## プロジェクトのセットアップ\n\nプロジェクトに貢献したり、ローカルで実行したりしたい場合は、次の手順に従ってください。\n\n1. リポジトリをクローンします。\n\n ```bash\n git clone https://github.com/b-open-io/bsv-mcp.git\n cd bsv-mcp\n ```\n\n2. 依存関係をインストールします:\n\n ```bash\n bun install\n # or with npm\n npm install\n ```\n\n## サーバーの実行\n\n```bash\nbun run index.ts\n# or with npm\nnpm run start\n```\n\n### テストの実行\n\n```bash\nbun test\n# or with npm\nnpm test\n```\n\n## ライセンス\n\nこのプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については[LICENSE](LICENSE)ファイルを参照してください。","Japanese","ja-JP",{"_29":56,"_37":60,"_39":61},{"_31":57,"_33":58,"_35":59},"AI 어시스턴트가 지갑 작업, 순서형(NFT) 및 다양한 블록체인 유틸리티를 통해 BSV 블록체인과 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜을 위한 Bitcoin SV 도구 모음입니다.","비트코인 SV MCP 서버","# 비트코인 SV MCP 서버\n\n[![대장간 배지](https://smithery.ai/badge/@b-open-io/bsv-mcp)](https://smithery.ai/server/@b-open-io/bsv-mcp)\n\n> **⚠️ 공지: 실험 작업 진행 중**\\\n> 이 프로젝트는 초기 실험 단계에 있습니다. 기능이 변경될 수 있으며 API는 아직 안정적이지 않습니다. 기여, 피드백, 버그 리포트를 환영합니다! 이슈를 생성하거나 풀 리퀘스트를 제출해 주세요.\n\n모델 컨텍스트 프로토콜(MCP) 프레임워크를 위한 비트코인 SV(BSV) 도구 모음입니다. 이 라이브러리는 BSV 블록체인 상호작용을 위한 지갑, 서수, 유틸리티 함수를 제공합니다.\n\n## 설치 및 설정\n\n### Bun을 사용하세요(선택 사항이지만 권장)\n\n이 프로젝트는 빠른 JavaScript 런타임이자 패키지 관리자인 [Bun을](https://bun.sh/) 사용하여 빌드되었습니다. 최상의 성능을 위해서는 Bun이 권장되지만, Bun은 Node.js와 하위 호환성을 갖도록 설계되었으므로 Node.js 및 npm으로도 서버를 실행할 수 있습니다.\n\n#### Bun 설치\n\n**macOS(Homebrew 사용):**\n\n지엑스피1\n\n**macOS/Linux/WSL(설치 스크립트 사용):**\n\n```bash\ncurl -fsSL https://bun.sh/install | bash\n```\n\n**Windows:** Windows 사용자는 WSL(Windows Subsystem for Linux) 또는 Docker를 사용하여 Bun을 실행해야 합니다.\n\nNode.js와 npm도 작동하지만 동일한 성능상의 이점을 제공하지 못할 수 있습니다.\n\n## MCP 클라이언트에 연결\n\n이 서버는 [모델 컨텍스트 프로토콜](https://modelcontextprotocol.io/) (MCP)을 구현하여 AI 어시스턴트가 비트코인 SV 기능을 활용할 수 있도록 합니다. 이 서버를 다양한 MCP 호환 클라이언트에 연결할 수 있습니다.\n\n![MCP 구성 예](docs/images/mcp-config-example.png)\n\n> **참고:** `PRIVATE_KEY_WIF` 환경 변수는 이제 선택 사항입니다. 이 변수가 없으면 서버는 교육 자료 및 지갑 관련 도구가 아닌 제한된 모드로 실행됩니다. 지갑 및 MNEE 토큰 작업에는 유효한 개인 키가 필요합니다. `IDENTITY_KEY_WIF` 환경 변수를 설정하여 인증, 큐레이션 및 신뢰 웹을 위한 서수 비문의 시그마 프로토콜 서명을 활성화할 수도 있습니다.\n\n### 커서\n\n[Cursor](https://cursor.sh/) 와 함께 BSV MCP 서버를 사용하려면:\n\n1. 아직 Cursor를 설치하지 않았다면 설치하세요.\n2. 커서를 열고 설정 → 확장 → 모델 컨텍스트 프로토콜로 이동합니다.\n3. \"새로운 글로벌 MCP 서버 추가\"를 클릭하세요.\n4. 다음 구성을 JSON 형식으로 입력하세요.\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bunx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n5. `` 실제 개인 키 WIF로 바꾸세요(보안에 유의하세요!). 개인 키 WIF가 없다면 지금은 이 부분을 해제해도 되지만, 지갑이 필요한 도구는 사용할 수 없습니다. `` 도 선택 사항입니다. 제공된 신원 키를 사용하여 시그마 프로토콜을 통해 1Sat Ordinals에 서명합니다.\n\n6. \"저장\"을 클릭하세요\n\nBSV 도구는 이제 \"Bitcoin SV\" 네임스페이스에서 Cursor의 AI 어시스턴트에서 사용할 수 있습니다.\n\n#### npm 사용자를 위한 대안\n\nBun 대신 npm을 사용하려면:\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"npx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n### 데스크톱용 클로드\n\n이 서버를 데스크톱용 Claude에 연결하려면:\n\n1. [데스크톱용 Claude를](https://claude.ai/desktop) 열고 Claude > 설정 > 개발자로 이동하세요.\n2. \"구성 편집\"을 클릭하세요.\n\n선호하는 텍스트 편집기에서 Claude 구성 JSON 파일을 엽니다. CLI에서 작업하는 것을 선호한다면 다음을 수행합니다.\n\n```bash\n# macOS/Linux\ncode ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n\n# Windows\ncode %APPDATA%\\Claude\\claude_desktop_config.json\n```\n\n3. 구성에 BSV MCP 서버를 추가합니다.\n\n ```json\n {\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bun\",\n \"args\": [\n \"run\", \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n }\n ```\n\n4. `` 실제 개인 키 WIF로 바꾸세요.\n\n5. 파일을 저장하고 Claude for Desktop을 다시 시작하세요.\n\n6. Claude for Desktop에서 도구 아이콘(망치)을 클릭하면 BSV 도구가 나타납니다.\n\n#### npm 사용자를 위한 대안(Claude)\n\nBun 대신 npm을 사용하려면 \"command\" 필드를 \"npx\"로 바꾸세요.\n\n## 사용 가능한 도구\n\n툴킷은 여러 카테고리로 구성되어 있습니다.\n\n### 지갑 도구\n\n지갑 도구는 핵심 BSV 지갑 기능을 제공합니다.\n\n| 도구 이름 | 설명 | 출력 예 |\n| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |\n| `wallet_getPublicKey` | 지정된 프로토콜과 키 ID에 대한 공개 키를 검색합니다. | `{\"publicKey\":\"032d0c73eb9270e9e009fd1f9dd77e19cf764fbad5f799560c4e8fd414e40d6fc2\"}` |\n| `wallet_createSignature` | 제공된 데이터에 대한 암호화 서명을 생성합니다. | `{\"signature\":[144,124,85,193,226,45,140,249,9,177,11,167,33,215,209,38,...]}` |\n| `wallet_verifySignature` | 제공된 데이터에 대해 암호화 서명을 확인합니다. | `{\"isValid\":true}` |\n| `wallet_encryption` | 지갑의 암호화 키를 사용하여 데이터를 암호화하고 복호화하는 통합 도구입니다. **예:** 1. 텍스트 암호화: `\"Encrypt this message: Hello World\"` 2. 데이터 복호화: `\"Decrypt this data that was previously encrypted for me\"` | 암호화: `{\"ciphertext\":[89,32,155,38,125,22,49,226,26,...]}` 복호화: `{\"plaintext\":\"hello world\"}` |\n| `wallet_getAddress` | 현재 지갑 또는 파생 경로에 대한 BSV 주소를 반환합니다. | `{\"address\":\"1ExampleBsvAddressXXXXXXXXXXXXXXXXX\",\"status\":\"ok\"}` |\n| `wallet_sendToAddress` | 지정된 주소로 BSV를 전송합니다(BSV 또는 USD 금액 지원) | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"satoshis\":1000000}` |\n| `wallet_purchaseListing` | 마켓플레이스 목록에서 NFT 또는 BSV-20/BSV-21 토큰을 구매합니다. | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"type\":\"nft\",\"origin\":\"abcdef123456...\"}` |\n| `wallet_createOrdinals` | BSV 블록체인에 순서를 생성하고 기록합니다. | `{\"txid\":\"a1b2c3d4e5f6...\",\"inscriptionAddress\":\"1ExampleAddress...\",\"contentType\":\"image/png\"}` |\n\n### BSV 도구\n\nBSV 블록체인 및 네트워크와 상호 작용하기 위한 도구:\n\n| 도구 이름 | 설명 | 출력 예 |\n| ----------------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------------------- |\n| `bsv_getPrice` | 거래소 API에서 현재 BSV 가격을 가져옵니다. | `Current BSV price: $38.75 USD` |\n| `bsv_decodeTransaction` | BSV 트랜잭션을 디코딩하고 자세한 정보를 반환합니다. | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,\"inputs\":[...],\"outputs\":[...]}` |\n| `bsv_explore` | WhatsOnChain API 엔드포인트에 액세스하는 포괄적인 블록체인 탐색기 도구 | `{\"chain_info\":{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}}` |\n\n### 순서형 도구\n\nBSV에서 순서형(NFT) 작업을 위한 도구:\n\n| 도구 이름 | 설명 | 출력 예 |\n| ------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |\n| `ordinals_getInscription` | 특정 비문에 대한 자세한 정보를 검색합니다. | `{\"id\":\"a1b2c3d4e5f6...\",\"origin\":\"a1b2c3d4e5f6...\",\"contentType\":\"image/png\",\"content\":\"iVBORw0KGgoAAA...\"}` |\n| `ordinals_searchInscriptions` | 다양한 기준에 따른 비문 검색 | `{\"results\":[{\"id\":\"a1b2c3...\",\"contentType\":\"image/png\",\"owner\":\"1Example...\"},...]}` |\n| `ordinals_marketListings` | 통합 인터페이스를 통해 NFT, BSV-20 및 BSV-21 토큰에 대한 시장 목록을 검색합니다. | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":9990000,\"tick\":\"PEPE\",\"listing\":true},...]}` |\n| `ordinals_marketSales` | BSV-20 및 BSV-21 토큰 시장 판매에 대한 정보를 얻습니다. | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":34710050,\"tick\":\"$BTC\",\"sale\":true},...]}` |\n| `ordinals_getTokenByIdOrTicker` | ID로 특정 BSV20 토큰에 대한 세부 정보를 검색합니다. | `{\"tick\":\"PEPE\",\"max\":\"21000000\",\"lim\":\"1000\",\"dec\":\"2\"}` |\n\n### 유틸리티 도구\n\n일반 용도 유틸리티 함수:\n\n| 도구 이름 | 설명 | 출력 예 |\n| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |\n| `utils_convertData` | 다양한 인코딩 형식(utf8, hex, base64, binary) 간에 데이터를 변환합니다. **매개 변수:** - `data` (필수): 변환할 문자열 - `from` (필수): 소스 인코딩 형식(utf8, hex, base64 또는 이진수) - `to` (필수): 대상 인코딩 형식(utf8, hex, base64 또는 이진수) **예:** - UTF-8에서 hex로: `{\"data\": \"hello world\", \"from\": \"utf8\", \"to\": \"hex\"}` → `68656c6c6f20776f726c64` - UTF-8에서 base64로: `{\"data\": \"Hello World\", \"from\": \"utf8\", \"to\": \"base64\"}` → `SGVsbG8gV29ybGQ=` - base64에서 UTF-8로: `{\"data\": \"SGVsbG8gV29ybGQ=\", \"from\": \"base64\", \"to\": \"utf8\"}` → `Hello World` - 16진수에서 base64로: `{\"data\": \"68656c6c6f20776f726c64\", \"from\": \"hex\", \"to\": \"base64\"}` → `aGVsbG8gd29ybGQ=` **참고:** - 모든 매개변수가 필요합니다. - 도구는 변환된 데이터를 문자열로 반환합니다. - 이진 변환의 경우 데이터는 바이트 값의 배열로 표현됩니다. | `\"SGVsbG8gV29ybGQ=\"` (UTF-8 \"Hello World\"를 base64로 변환) |\n\n### MNEE 도구\n\nMNEE 토큰 작업을 위한 도구:\n\n| 도구 이름 | 설명 | 출력 예 |\n| ----------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `mnee_getBalance` | 지갑의 현재 MNEE 토큰 잔액을 검색합니다. | `{\"balance\": {\"amount\": 2900, \"decimalAmount\": 0.029}}` |\n| `mnee_sendMnee` | 지정된 주소로 MNEE 토큰을 보내세요. MNEE 및 USD 금액을 모두 지원합니다. | `{\"success\": true, \"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"rawtx\": \"0100000002a0be40d8942015f1...\", \"mneeAmount\": 0.01, \"usdAmount\": \"$0.01\", \"recipient\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\"}` |\n| `mnee_parseTx` | MNEE 거래를 파싱하여 해당 거래 내역 및 금액에 대한 자세한 정보를 얻습니다. 모든 금액은 소수점 이하 5자리까지 표시되는 원자 단위(예: 1000 원자 단위 = 0.01 MNEE)입니다. | `{\"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"environment\": \"production\", \"type\": \"transfer\", \"inputs\": [{\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 2900}], \"outputs\": [{\"address\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\", \"amount\": 1000}, {\"address\": \"19Vq2TV8aVhFNLQkhDMdnEQ7zT96x6F3PK\", \"amount\": 100}, {\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 1800}]}` |\n\n## MCP와 함께 도구 사용\n\n연결되면 AI 비서를 통해 자연어를 사용하여 Bitcoin SV와 상호 작용할 수 있습니다. 다음은 몇 가지 프롬프트 예시입니다.\n\n### 지갑 운영\n\n* \"내 비트코인 SV 주소를 받아보세요\"\n* \"0.01 BSV를 1ExampleBsvAddressXXXXXXXXXXXXXXXXX로 전송\"\n* \"1ExampleBsvAddressXXXXXXXXXXXXXXXXX로 5달러 상당의 BSV를 보내세요\"\n* \"0.01 MNEE를 1ExampleBsvAddressXXXXXXXXXXXXXXXXX로 전송\"\n* \"내 MNEE 잔액을 확인하세요\"\n* \"이 MNEE 거래를 구문 분석하세요: txid\"\n* \"내 지갑 키를 사용하여 이 메시지를 암호화합니다\"\n* \"이전에 나를 위해 암호화된 데이터를 해독해 주세요\"\n* \"이 NFT 목록을 구매하세요: txid\\_vout\"\n* \"이 BSV-20 토큰 목록을 구매하세요: txid\\_vout\"\n\n### 순서형(NFT)\n\n* \"아웃포인트 6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325\\_0을 사용하여 NFT에 대한 정보를 보여주세요\"\n* \"픽셀 조이드 NFT를 검색하세요\"\n* \"BSV NFT에 대한 현재 마켓플레이스 목록을 보여주세요\"\n* \"PEPE 티커에 대한 BSV-20 토큰 목록을 보여주세요\"\n* \"최근 BSV-20 토큰 판매 내역을 확인하세요\"\n\n### 블록체인 운영\n\n* \"현재 BSV 가격은 얼마인가요?\"\n* \"이 BSV 트랜잭션을 디코딩하세요: (트랜잭션 16진수 또는 ID)\"\n* \"최신 비트코인 SV 체인 정보를 받아보세요\"\n* \"높이 800000에 대한 블록 세부 정보를 보여주세요\"\n* \"주소 1ExampleBsvAddressXXXX에 대한 거래 내역을 탐색하세요\"\n* \"내 지갑 주소에 대한 사용되지 않은 출력(UTXO)을 확인하세요\"\n* \"해시 a1b2c3d4e5f6를 사용하여 거래에 대한 세부 정보를 얻으세요...\"\n\n### 데이터 변환\n\n* \"UTF-8에서 16진수 형식으로 'Hello World'를 변환합니다\"\n\n## MCP 프롬프트 및 리소스\n\nBSV MCP 서버는 비트코인 SV 기술에 대한 자세한 정보와 맥락을 제공하는 특수 프롬프트와 리소스를 제공합니다. AI 모델은 이러한 정보에 접근하여 이해도와 역량을 향상시킬 수 있습니다.\n\n### 사용 가능한 프롬프트\n\n서버는 MCP 프로토콜을 통해 직접 액세스할 수 있는 다음과 같은 교육 프롬프트를 제공합니다.\n\n#### 순서형 프롬프트\n\n* **식별자** : `bitcoin_sv_ordinals`\n* **설명** : Bitcoin SV 순서수에 대한 포괄적인 정보로, 순서수가 무엇인지, 어떻게 작동하는지, 어떻게 사용하는지 등이 나와 있습니다.\n* **사용법** : 이 정보에 접근하려면 도우미에게 \"Bitcoin SV ordinals\" 또는 \"1Sat Ordinals\"에 대해 물어보세요.\n\n#### BSV SDK 프롬프트\n\nBitcoin SV SDK에 대한 자세한 정보를 제공하는 프롬프트 모음:\n\n* **개요**\n\n * **식별자** : `bitcoin_sv_sdk_overview`\n * **설명** : Bitcoin SV SDK의 일반적인 개요, 목적 및 주요 구성 요소 포함.\n * **사용법** : \"BSV SDK에 대해 알려주세요\" 또는 \"Bitcoin SV SDK가 무엇인가요?\"\n\n* **지갑 운영**\n\n * **식별자** : `bitcoin_sv_sdk_wallet`\n * **설명** : BSV SDK의 지갑 작업에 대한 정보입니다.\n * **사용법** : \"BSV SDK에서 지갑 작업은 어떻게 작동합니까?\"\n\n* **거래 빌딩**\n\n * **식별자** : `bitcoin_sv_sdk_transaction`\n * **설명** : 거래 생성 및 조작에 대한 세부 정보입니다.\n * **사용법** : \"BSV SDK 트랜잭션 빌드에 대해 설명하세요\" 또는 \"BSV SDK로 트랜잭션을 어떻게 생성하나요?\"\n\n* **입증**\n\n * **식별자** : `bitcoin_sv_sdk_auth`\n * **설명** : BSV SDK의 인증 및 ID 프로토콜.\n * **사용법** : \"BSV SDK를 사용하면 인증이 어떻게 작동합니까?\"\n\n* **암호화**\n\n * **식별자** : `bitcoin_sv_sdk_cryptography`\n * **설명** : 서명, 암호화, 검증 기능.\n * **사용법** : \"BSV SDK 암호화 기능 설명\"\n\n* **스크립팅**\n\n * **식별자** : `bitcoin_sv_sdk_script`\n * **설명** : 비트코인 스크립팅 및 계약 기능.\n * **사용법** : \"BSV SDK를 사용하여 비트코인 스크립트를 어떻게 사용합니까?\"\n\n* **원시**\n\n * **식별자** : `bitcoin_sv_sdk_primitives`\n * **설명** : BSV SDK의 핵심 데이터 유형 및 구조.\n * **사용법** : \"BSV SDK에서 사용할 수 있는 기본 요소는 무엇입니까?\"\n\n### 사용 가능한 리소스\n\n이 서버는 또한 Bitcoin Request for Comments(BRC) 사양 및 문서에 대한 액세스를 제공합니다.\n\n#### 변경 로그 리소스\n\n* **식별자** : `bsv-mcp-changelog`\n* **설명** : BSV MCP 서버의 버전 기록 및 변경 로그입니다.\n* **사용법** : \"BSV MCP 변경 사항을 보여주세요\" 또는 \"최신 버전의 새로운 기능은 무엇인가요?\"\n\n#### BRC 리소스\n\n* **BRC 개요**\n\n * **식별자** : `brcs_readme`\n * **설명** : BRC 저장소에 있는 모든 Bitcoin SV 프로토콜 사양에 대한 개요입니다.\n * **사용법** : \"Bitcoin SV BRC 개요 보기\"\n\n* **BRC 요약**\n\n * **식별자** : `brcs_summary`\n * **설명** : 모든 Bitcoin SV BRC에 대한 목차입니다.\n * **사용법** : \"Bitcoin SV BRC에 대한 요약을 알려주세요\"\n\n* **특정 BRC 사양**\n\n * **식별자** : `brc_spec`\n * **설명** : 범주 및 번호별로 특정 BRC 사양에 접근합니다.\n * **사용법** : \"거래 봉투에 BRC 8을 표시해 주세요\" 또는 \"BRC 1은 무엇을 지정합니까?\"\n\n#### BRC 카테고리\n\nBRC 사양은 다음 범주로 구성됩니다.\n\n* 지갑\n* 업무\n* 스크립트\n* 토큰\n* 오버레이\n* 결제\n* 피어투피어\n* 키 유도\n* 아웃포인트\n* 의견\n* 상태 머신\n* 앱\n\n### 프롬프트 및 리소스 사용\n\nAI 모델은 이러한 프롬프트와 리소스를 사용하여 비트코인 SV 기술에 대해 더욱 정확하고 자세한 답변을 제공할 수 있습니다. 사용자는 다음을 수행할 수 있습니다.\n\n1. **특정 주제에 대해 질문하세요** : \"Bitcoin SV 순서수에 대해 알려주세요\" 또는 \"BSV SDK 거래 구성에 대해 설명해 주세요\"\n2. **특정 BRC 세부 정보 요청** : \"BRC 8은 무엇을 지정합니까?\" 또는 \"거래 생성 시 BRC 표시\"\n3. **일반적인 개요 보기** : \"BSV SDK란 무엇입니까?\" 또는 \"모든 BRC 요약 보기\"\n\n이러한 프롬프트와 리소스는 AI의 지식 기반을 강화하여 복잡한 Bitcoin SV 주제에 대해서도 보다 기술적이고 정확한 응답을 가능하게 합니다.\n\n## MCP 작동 방식\n\nMCP 지원 AI 어시스턴트와 상호 작용하는 경우:\n\n1. AI는 귀하의 요청을 분석하고 어떤 도구를 사용할지 결정합니다.\n2. 귀하의 승인 하에 적절한 BSV MCP 도구가 호출됩니다.\n3. 서버는 Bitcoin SV 블록체인에서 요청된 작업을 실행합니다.\n4. 결과는 AI 어시스턴트에게 반환됩니다.\n5. 보조자는 자연스럽고 대화적인 방식으로 정보를 제공합니다.\n\n## 사용자 정의 옵션\n\nBSV MCP 서버는 환경 변수를 사용하여 사용자 정의하여 특정 구성 요소를 활성화하거나 비활성화할 수 있습니다.\n\n### 구성 요소 구성\n\n| 환경 변수 | 기본 | 설명 |\n| ------------------- | ------- | ------------------------------------------- |\n| `DISABLE_PROMPTS` | `false` | 모든 교육적 메시지를 비활성화하려면 `true` 로 설정합니다. |\n| `DISABLE_RESOURCES` | `false` | 모든 리소스(BRC, 변경 로그)를 비활성화하려면 `true` 로 설정합니다. |\n| `DISABLE_TOOLS` | `false` | 모든 도구를 비활성화하려면 `true` 로 설정합니다. |\n\n### 도구별 구성\n\n| 환경 변수 | 기본 | 설명 |\n| ------------------------ | --------- | ------------------------------------------------------------------------------------------- |\n| `DISABLE_WALLET_TOOLS` | `false` | 비트코인 지갑 도구를 비활성화하려면 `true` 로 설정하세요. |\n| `DISABLE_MNEE_TOOLS` | `false` | MNEE 토큰 도구를 비활성화하려면 `true` 로 설정하세요. |\n| `DISABLE_BSV_TOOLS` | `false` | BSV 블록체인 도구를 비활성화하려면 `true` 로 설정하세요. |\n| `DISABLE_ORDINALS_TOOLS` | `false` | Ordinals/NFT 도구를 비활성화하려면 `true` 로 설정합니다. |\n| `DISABLE_UTILS_TOOLS` | `false` | 유틸리티 도구를 비활성화하려면 `true` 로 설정합니다. |\n| `IDENTITY_KEY_WIF` | `not set` | 신원 키에 대한 선택적 WIF입니다. 설정된 경우, 순서형 비문은 인증, 큐레이션 및 신뢰 웹을 위해 시그마 프로토콜로 서명됩니다. |\n| `DISABLE_BROADCASTING` | `false` | 트랜잭션 브로드캐스팅을 비활성화하려면 `true` 로 설정합니다. 대신 원시 트랜잭션 16진수를 반환합니다. 브로드캐스팅 전 테스트 및 트랜잭션 검토에 유용합니다. |\n\n### 예시\n\n도구 없이 교육 자료와 프롬프트만 사용하여 실행하세요.\n\n```bash\nDISABLE_TOOLS=true bunx bsv-mcp@latest\n```\n\nBSV 도구만 사용하여 실행하고 지갑이나 다른 기능은 사용하지 않습니다.\n\n```bash\nDISABLE_PROMPTS=true DISABLE_RESOURCES=true DISABLE_WALLET_TOOLS=true DISABLE_MNEE_TOOLS=true DISABLE_ORDINALS_TOOLS=true DISABLE_UTILS_TOOLS=true bunx bsv-mcp@latest\n```\n\n지갑 작업을 제외한 모든 도구를 사용하세요:\n\n```bash\nDISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest\n```\n\n브로드캐스트하지 않고 거래 생성(테스트 실행 모드):\n\n```bash\nDISABLE_BROADCASTING=true bunx bsv-mcp@latest\n```\n\n## 문제 해결\n\nBSV MCP 서버에 문제가 있는 경우:\n\n### 연결 문제\n\n1. 시스템에 Bun 또는 Node.js가 설치되어 있는지 확인하세요.\n2. WIF 개인 키가 환경에 올바르게 설정되었는지 확인하세요.\n3. 클라이언트가 MCP를 지원하고 올바르게 구성되었는지 확인하세요.\n4. 클라이언트 콘솔 출력에서 오류 메시지를 찾으세요.\n\n### Bun을 최신 상태로 유지하기\n\n호환성을 보장하려면 Bun을 최신 버전으로 업데이트하는 것이 중요합니다.\n\n```bash\n# Update Bun to the latest version\nbun upgrade\n```\n\n현재 Bun 버전을 확인하려면:\n\n```bash\nbun --version\n```\n\n### 로깅 및 디버깅\n\n데스크톱용 Claude의 경우 다음에서 로그를 확인하세요.\n\n```bash\n# macOS/Linux\ntail -n 20 -f ~/Library/Logs/Claude/mcp*.log\n\n# Windows\ntype %APPDATA%\\Claude\\Logs\\mcp*.log\n```\n\n커서의 경우 설정 → 확장 → 모델 컨텍스트 프로토콜에서 커서 MCP 로그를 확인하세요.\n\n## 최근 업데이트\n\n* **거래 브로드캐스트 제어** : 거래가 네트워크로 브로드캐스트되는 것을 방지하기 위해 `DISABLE_BROADCASTING` 환경 변수가 추가되었습니다.\n* **블록체인 탐색기** : 메인넷/테스트넷 지원을 통해 WhatsOnChain API 액세스를 위한 `bsv_explore` 도구가 추가되었습니다.\n* **통합 도구** : `wallet_encrypt` / `wallet_decrypt` 단일 `wallet_encryption` 도구로 통합\n* **향상된 마켓플레이스** : 상장, 판매 및 구매에서 NFT, BSV-20/21 토큰 지원\n* **성능** : 가격 캐싱 추가 및 API 엔드포인트 구조 최적화\n* **개선된 유효성 검사** : 개인 키 및 매개변수에 대한 더 나은 오류 처리\n\n## 비트코인 SV 블록체인 탐색기\n\n`bsv_explore` 도구는 WhatsOnChain API를 통해 비트코인 SV 블록체인에 대한 포괄적인 접근을 제공합니다. 이 강력한 탐색기 도구를 사용하면 체인 데이터, 블록, 거래 내역, 주소 정보 등 블록체인의 다양한 측면을 조회할 수 있습니다.\n\n### 사용 가능한 엔드포인트\n\n이 도구는 다음과 같은 엔드포인트 범주와 특정 엔드포인트를 지원합니다.\n\n#### 체인 데이터\n\n| 엔드포인트 | 설명 | 필수 매개변수 | 예시 응답 |\n| -------------------- | -------------------- | ------- | ----------------------------------------------------------------------------------- |\n| `chain_info` | 네트워크 통계, 난이도 및 체인 작업 | 없음 | `{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}` |\n| `chain_tips` | 높이와 상태를 포함한 현재 체인 팁 | 없음 | `[{\"height\":826458,\"hash\":\"000000000000...\",\"branchlen\":0,\"status\":\"active\"}]` |\n| `circulating_supply` | 현재 BSV 순환 공급량 | 없음 | `{\"bsv\":21000000}` |\n| `peer_info` | 연결된 피어 통계 | 없음 | `[{\"addr\":\"1.2.3.4:8333\",\"services\":\"000000000000...\",\"lastsend\":1621234567}]` |\n\n#### 블록 데이터\n\n| 엔드포인트 | 설명 | 필수 매개변수 | 예시 응답 |\n| --------------------- | ---------------------------- | --------------------------------- | -------------------------------------------------------------------------- |\n| `block_by_hash` | 해시를 통한 완전한 블록 데이터 | `blockHash` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `block_by_height` | 높이를 통한 완전한 블록 데이터 | `blockHeight` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `tag_count_by_height` | 특정 블록의 태그 수에 대한 통계 | `blockHeight` | `{\"tags\":{\"amp\":3,\"bitkey\":5,\"metanet\":12,\"planaria\":7,\"b\":120}}` |\n| `block_headers` | 마지막 10개 블록 헤더를 검색합니다. | 없음 | `[{\"hash\":\"000000000000...\",\"height\":826458,\"version\":536870912,...},...]` |\n| `block_pages` | 대규모 블록에 대한 거래 ID 페이지를 검색합니다. | `blockHash` , 선택 사항: `pageNumber` | `[\"tx1hash\",\"tx2hash\",\"tx3hash\",...]` |\n\n#### 통계 데이터\n\n| 엔드포인트 | 설명 | 필수 매개변수 | 예시 응답 |\n| ----------------------- | ------------------- | --------------------- | -------------------------------------------------------------------------------------- |\n| `block_stats_by_height` | 특정 높이에 대한 블록 통계 | `blockHeight` | `{\"size\":123456,\"txCount\":512,\"outputTotal\":54.12345678,\"outputTotalUsd\":2345.67,...}` |\n| `block_miner_stats` | 특정 기간 동안의 블록 마이닝 통계 | 선택 사항: `days` (기본값 7) | `{\"blocks\":{\"miner1\":412,\"miner2\":208,...},\"total\":1008}` |\n| `miner_summary_stats` | 광산 통계 요약 | 선택 사항: `days` (기본값 7) | `{\"totalBlocks\":1008,\"totalFees\":1.23456789,\"totalFeesUsd\":53.67,...}` |\n\n#### 거래 데이터\n\n| 엔드포인트 | 설명 | 필수 매개변수 | 예시 응답 |\n| ----------------- | ------------------ | ------------ | ------------------------------------------------------------------------------------------ |\n| `tx_by_hash` | 자세한 거래 데이터 | `txHash` | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,...}` |\n| `tx_raw` | 원시 거래 16진수 데이터 | `txHash` | `\"01000000012345abcdef...\"` |\n| `tx_receipt` | 거래 영수증 | `txHash` | `{\"blockHash\":\"000000000000...\",\"blockHeight\":800000,\"confirmations\":26458}` |\n| `bulk_tx_details` | 한 번의 요청으로 여러 거래 검색 | `txids` (배열) | `[{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,...}, {\"txid\":\"b2c3d4e5f6a7...\",\"version\":1,...}]` |\n\n#### 주소 데이터\n\n| 엔드포인트 | 설명 | 필수 매개변수 | 예시 응답 |\n| ----------------- | ----------------- | -------------------------- | --------------------------------------------------------------- |\n| `address_history` | 주소별 거래 내역 | `address` , 선택 사항: `limit` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"height\":800000},...]` |\n| `address_utxos` | 주소에 대한 사용되지 않은 출력 | `address` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"tx_pos\":0,\"value\":100000},...]` |\n\n#### 회로망\n\n| 엔드포인트 | 설명 | 필수 매개변수 | 예시 응답 |\n| -------- | --------- | ------- | --------------------- |\n| `health` | API 상태 점검 | 없음 | `{\"status\":\"synced\"}` |\n\n### 사용 예\n\n`bsv_explore` 도구는 다음과 같은 자연어 프롬프트와 함께 사용할 수 있습니다.\n\n```\n\"Get the current Bitcoin SV blockchain information\"\n\"Show me block #800000 details\"\n\"Get tag count statistics for block #800000\"\n\"Fetch transaction history for address 1ExampleBsvAddressXXXXXXXX\"\n\"Get unspent outputs for my wallet address\"\n\"Check transaction details for txid a1b2c3d4e5f6...\"\n\"What is the current BSV circulating supply?\"\n\"Show me the latest block headers\"\n\"Get transaction IDs for page 2 of a large block\"\n\"Show me block statistics for height 800000\"\n\"What are the mining statistics for the last 14 days?\"\n\"Get a summary of mining activity over the past 30 days\"\n\"Retrieve details for multiple transactions in a single query\"\n```\n\n도구의 내부적으로는 어떤 데이터를 검색할지 지정하는 매개변수를 허용합니다.\n\n* `endpoint` : 쿼리할 특정 WhatsOnChain 엔드포인트(예: `chain_info` , `tx_by_hash` )\n* `network` : 사용할 BSV 네트워크( `main` 또는 `test` )\n* 특정 엔드포인트에 필요한 추가 매개변수:\n * `blockHash` : block\\_by\\_hash 및 block\\_pages 엔드포인트용\n * `blockHeight` : block\\_by\\_height, tag\\_count\\_by\\_height 및 block\\_stats\\_by\\_height 엔드포인트의 경우\n * `pageNumber` : block\\_pages 엔드포인트(페이지 매김)용\n * `days` : block\\_miner\\_stats 및 miner\\_summary\\_stats 엔드포인트의 경우(기본값은 7)\n * `txHash` : 거래 관련 엔드포인트(tx\\_by\\_hash, tx\\_raw, tx\\_receipt)\n * `txids` : bulk\\_tx\\_details 엔드포인트(트랜잭션 ID 배열)\n * `address` : 주소 관련 엔드포인트의 경우\n * `limit` : address\\_history에 대한 선택적 페이지 매김 제한\n\n### 네트워크 옵션\n\n이 도구는 메인넷과 테스트넷을 모두 지원합니다.\n\n* `main` : 비트코인 SV 메인넷(기본)\n* `test` : 비트코인 SV 테스트넷\n\n# 개발\n\n## 프로젝트 설정\n\n프로젝트에 기여하거나 로컬로 실행하고 싶다면:\n\n1. 저장소를 복제합니다.\n\n ```bash\n git clone https://github.com/b-open-io/bsv-mcp.git\n cd bsv-mcp\n ```\n\n2. 종속성 설치:\n\n ```bash\n bun install\n # or with npm\n npm install\n ```\n\n## 서버 실행\n\n```bash\nbun run index.ts\n# or with npm\nnpm run start\n```\n\n### 테스트 실행\n\n```bash\nbun test\n# or with npm\nnpm test\n```\n\n## 특허\n\n이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 [라이선스](LICENSE) 파일을 참조하세요.","Korean","ko-KR",{"_29":63,"_37":67,"_39":68},{"_31":64,"_33":65,"_35":66},"用于模型上下文协议的比特币 SV 工具集合，使 AI 助手能够通过钱包操作、序数 (NFT) 和各种区块链实用程序与 BSV 区块链进行交互。","比特币SV MCP服务器","# 比特币SV MCP服务器\n\n[![铁匠徽章](https://smithery.ai/badge/@b-open-io/bsv-mcp)](https://smithery.ai/server/@b-open-io/bsv-mcp)\n\n> **⚠️ 注意：实验工作正在进行中**\\\n> 该项目处于早期实验阶段。功能可能会发生变化，API 也尚未稳定。欢迎贡献代码、提供反馈和报告错误！欢迎随时提交问题或拉取请求。\n\n适用于模型上下文协议 (MCP) 框架的比特币 SV (BSV) 工具集合。该库提供用于 BSV 区块链交互的钱包、序数函数和实用函数。\n\n## 安装和设置\n\n### 使用发髻（可选但推荐）\n\n该项目使用[Bun](https://bun.sh/)构建，Bun 是一个快速的 JavaScript 运行时和包管理器。虽然建议使用 Bun 以获得最佳性能，但该服务器也可以使用 Node.js 和 npm 运行，因为 Bun 的设计与 Node.js 向后兼容。\n\n#### 安装 Bun\n\n**macOS（使用 Homebrew）：**\n\n```bash\nbrew install oven-sh/bun/bun\n```\n\n**macOS/Linux/WSL（使用安装程序脚本）：**\n\n```bash\ncurl -fsSL https://bun.sh/install | bash\n```\n\n**Windows：** Windows 用户应该使用 WSL（Windows Subsystem for Linux）或 Docker 来运行 Bun。\n\nNode.js 和 npm 也可以工作，但可能无法提供相同的性能优势。\n\n## 连接到 MCP 客户端\n\n该服务器实现了[模型上下文协议](https://modelcontextprotocol.io/)(MCP)，允许人工智能助手使用比特币 SV 的功能。您可以将此服务器连接到各种兼容 MCP 的客户端。\n\n![MCP 配置示例](docs/images/mcp-config-example.png)\n\n> **注意：** `PRIVATE_KEY_WIF`环境变量现在是可选的。如果没有它，服务器将以受限模式运行，仅提供教育资源和非钱包工具。钱包和 MNEE 代币操作需要有效的私钥。您还可以设置`IDENTITY_KEY_WIF`环境变量，以启用 sigma-protocol 对序数铭文进行签名，用于身份验证、策展和信任网络。\n\n### 光标\n\n要将 BSV MCP 服务器与[Cursor](https://cursor.sh/)一起使用：\n\n1. 如果尚未安装 Cursor，请安装\n2. 打开 Cursor 并导航至“设置”→“扩展”→“模型上下文协议”\n3. 点击“添加新的全局 MCP 服务器”\n4. 以 JSON 格式输入以下配置：\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bunx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n5. 将``替换为您的实际私钥 WIF（请务必妥善保管！）。如果您没有，可以暂时不填写，但您将无法使用需要钱包的工具。 ``也是可选的。它将使用提供的身份密钥通过 Sigma 协议对 1Sat Ordinals 进行签名。\n\n6. 点击“保存”\n\nBSV 工具现在将在“比特币 SV”命名空间下供 Cursor 的 AI 助手使用。\n\n#### npm 用户的替代方案\n\n如果您更喜欢使用 npm 而不是 Bun：\n\n```json\n{\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"npx\",\n \"args\": [\n \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n}\n```\n\n### 克劳德桌面版\n\n要将此服务器连接到 Claude for Desktop：\n\n1. 打开[Claude for Desktop](https://claude.ai/desktop)并转到 Claude > 设置 > 开发者\n2. 单击“编辑配置”。\n\n用你喜欢的文本编辑器打开 Claude 配置 json 文件。如果你更喜欢使用命令行方式：\n\n```bash\n# macOS/Linux\ncode ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n\n# Windows\ncode %APPDATA%\\Claude\\claude_desktop_config.json\n```\n\n3. 将 BSV MCP 服务器添加到您的配置中：\n\n ```json\n {\n \"mcpServers\": {\n \"Bitcoin SV\": {\n \"command\": \"bun\",\n \"args\": [\n \"run\", \"bsv-mcp@latest\"\n ],\n \"env\": {\n \"PRIVATE_KEY_WIF\": \"\",\n \"IDENTITY_KEY_WIF\": \"\"\n }\n }\n }\n }\n ```\n\n4. 将``替换为你的实际私钥 WIF\n\n5. 保存文件并重新启动 Claude for Desktop\n\n6. 单击 Claude 桌面版中的工具图标（锤子）时，BSV 工具将会出现\n\n#### npm 用户的替代方案 (Claude)\n\n如果您更喜欢使用 npm 而不是 Bun，请将“命令”字段替换为“npx”。\n\n## 可用工具\n\n该工具包分为几类：\n\n### 钱包工具\n\n钱包工具提供核心 BSV 钱包功能：\n\n| 工具名称 | 描述 | 示例输出 |\n| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |\n| `wallet_getPublicKey` | 检索指定协议和密钥 ID 的公钥 | `{\"publicKey\":\"032d0c73eb9270e9e009fd1f9dd77e19cf764fbad5f799560c4e8fd414e40d6fc2\"}` |\n| `wallet_createSignature` | 为提供的数据创建加密签名 | `{\"signature\":[144,124,85,193,226,45,140,249,9,177,11,167,33,215,209,38,...]}` |\n| `wallet_verifySignature` | 根据提供的数据验证加密签名 | `{\"isValid\":true}` |\n| `wallet_encryption` | 使用钱包密钥加密和解密数据的组合工具。**示例：** 1. 加密文本： `\"Encrypt this message: Hello World\"` 2. 解密数据： `\"Decrypt this data that was previously encrypted for me\"` | 加密： `{\"ciphertext\":[89,32,155,38,125,22,49,226,26,...]}`解密： `{\"plaintext\":\"hello world\"}` |\n| `wallet_getAddress` | 返回当前钱包或派生路径的 BSV 地址 | `{\"address\":\"1ExampleBsvAddressXXXXXXXXXXXXXXXXX\",\"status\":\"ok\"}` |\n| `wallet_sendToAddress` | 将 BSV 发送到指定地址（支持 BSV 或 USD 金额） | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"satoshis\":1000000}` |\n| `wallet_purchaseListing` | 从市场列表中购买 NFT 或 BSV-20/BSV-21 代币 | `{\"status\":\"success\",\"txid\":\"a1b2c3d4e5f6...\",\"type\":\"nft\",\"origin\":\"abcdef123456...\"}` |\n| `wallet_createOrdinals` | 在 BSV 区块链上创建并记录序数 | `{\"txid\":\"a1b2c3d4e5f6...\",\"inscriptionAddress\":\"1ExampleAddress...\",\"contentType\":\"image/png\"}` |\n\n### BSV 工具\n\n与 BSV 区块链和网络交互的工具：\n\n| 工具名称 | 描述 | 示例输出 |\n| ----------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------- |\n| `bsv_getPrice` | 从交易所 API 获取当前 BSV 价格 | `Current BSV price: $38.75 USD` |\n| `bsv_decodeTransaction` | 解码 BSV 交易并返回详细信息 | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,\"inputs\":[...],\"outputs\":[...]}` |\n| `bsv_explore` | 全面的区块链探索工具，可访问 WhatsOnChain API 端点 | `{\"chain_info\":{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}}` |\n\n### 序数工具\n\n在 BSV 上使用序数 (NFT) 的工具：\n\n| 工具名称 | 描述 | 示例输出 |\n| ------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------- |\n| `ordinals_getInscription` | 检索有关特定铭文的详细信息 | `{\"id\":\"a1b2c3d4e5f6...\",\"origin\":\"a1b2c3d4e5f6...\",\"contentType\":\"image/png\",\"content\":\"iVBORw0KGgoAAA...\"}` |\n| `ordinals_searchInscriptions` | 根据各种标准搜索铭文 | `{\"results\":[{\"id\":\"a1b2c3...\",\"contentType\":\"image/png\",\"owner\":\"1Example...\"},...]}` |\n| `ordinals_marketListings` | 使用统一界面检索 NFT、BSV-20 和 BSV-21 代币的市场列表 | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":9990000,\"tick\":\"PEPE\",\"listing\":true},...]}` |\n| `ordinals_marketSales` | 获取有关 BSV-20 和 BSV-21 代币市场销售的信息 | `{\"results\":[{\"txid\":\"a1b2c3...\",\"price\":34710050,\"tick\":\"$BTC\",\"sale\":true},...]}` |\n| `ordinals_getTokenByIdOrTicker` | 通过 ID 检索特定 BSV20 代币的详细信息 | `{\"tick\":\"PEPE\",\"max\":\"21000000\",\"lim\":\"1000\",\"dec\":\"2\"}` |\n\n### 实用工具\n\n通用实用功能：\n\n| 工具名称 | 描述 | 示例输出 |\n| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |\n| `utils_convertData` | 在不同的编码格式（utf8、hex、base64、binary）之间转换数据。**参数：** - `data` （必需）：要转换的字符串 - `from` （必需）：源编码格式（utf8、hex、base64 或 binary） - `to` （必需）：目标编码格式（utf8、hex、base64 或 binary）**示例：** - UTF-8 到 hex： `{\"data\": \"hello world\", \"from\": \"utf8\", \"to\": \"hex\"}` → `68656c6c6f20776f726c64` - UTF-8 到 base64： `{\"data\": \"Hello World\", \"from\": \"utf8\", \"to\": \"base64\"}` → `SGVsbG8gV29ybGQ=` - base64 到 UTF-8： `{\"data\": \"SGVsbG8gV29ybGQ=\", \"from\": \"base64\", \"to\": \"utf8\"}` → `Hello World` - hex 到 base64： `{\"data\": \"68656c6c6f20776f726c64\", \"from\": \"hex\", \"to\": \"base64\"}` → `aGVsbG8gd29ybGQ=`**注意：** - 所有参数均为必填项 - 该工具将转换后的数据作为字符串返回 - 对于二进制转换，数据表示为字节值数组 | `\"SGVsbG8gV29ybGQ=\"` （UTF-8“Hello World”转换为base64） |\n\n### MNEE 工具\n\n使用 MNEE 代币的工具：\n\n| 工具名称 | 描述 | 示例输出 |\n| ----------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `mnee_getBalance` | 检索钱包的当前 MNEE 代币余额 | `{\"balance\": {\"amount\": 2900, \"decimalAmount\": 0.029}}` |\n| `mnee_sendMnee` | 将 MNEE 代币发送到指定地址。支持 MNEE 和 USD 金额 | `{\"success\": true, \"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"rawtx\": \"0100000002a0be40d8942015f1...\", \"mneeAmount\": 0.01, \"usdAmount\": \"$0.01\", \"recipient\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\"}` |\n| `mnee_parseTx` | 解析 MNEE 交易，获取其操作和金额的详细信息。所有金额均以原子单位表示，精确到小数点后 5 位（例如，1000 个原子单位 = 0.01 MNEE）。 | `{\"txid\": \"d1ce853934964e6c1fe9f44c918a824f175c6ab466b966f49ebc0682a8318895\", \"environment\": \"production\", \"type\": \"transfer\", \"inputs\": [{\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 2900}], \"outputs\": [{\"address\": \"15mNxEkyKJXPD8amic6oLUjS45zBKQQoLu\", \"amount\": 1000}, {\"address\": \"19Vq2TV8aVhFNLQkhDMdnEQ7zT96x6F3PK\", \"amount\": 100}, {\"address\": \"18izL7Wtm2fx3ALoRY3MkY2VFSMjArP62D\", \"amount\": 1800}]}` |\n\n## 使用 MCP 工具\n\n连接后，您可以通过人工智能助手使用自然语言与比特币 SV 进行交互。以下是一些示例提示：\n\n### 钱包操作\n\n* “获取我的比特币SV地址”\n* “发送 0.01 BSV 到 1ExampleBsvAddressXXXXXXXXXXXXXXXXX”\n* “将价值 5 美元的 BSV 发送至 1ExampleBsvAddressXXXXXXXXXXXXXXXXX”\n* “向 1ExampleBsvAddressXXXXXXXXXXXXXXXXX 发送 0.01 MNEE”\n* “检查我的 MNEE 余额”\n* “解析此 MNEE 交易：txid”\n* “使用我的钱包密钥加密此消息”\n* “解密之前为我加密的数据”\n* “购买此 NFT 列表：txid\\_vout”\n* “购买此 BSV-20 代币列表：txid\\_vout”\n\n### 序数（NFT）\n\n* “显示有关输出点为 6a89047af2cfac96da17d51ae8eb62c5f1d982be2bc4ba0d0cd2084b7ffed325\\_0 的 NFT 的信息”\n* “搜索 Pixel Zoide NFT”\n* “显示 BSV NFT 的当前市场列表”\n* “显示代码为 PEPE 的 BSV-20 代币列表”\n* “获取最近的 BSV-20 代币销售信息”\n\n### 区块链操作\n\n* “BSV 目前的价格是多少？”\n* “解码此 BSV 交易：（交易十六进制或 ID）”\n* “获取最新的比特币SV链信息”\n* “显示高度 800000 的区块详细信息”\n* “探索地址 1ExampleBsvAddressXXXX 的交易历史记录”\n* “检查我的钱包地址中的未使用输出（UTXO）”\n* “获取哈希 a1b2c3d4e5f6 的交易详细信息...”\n\n### 数据转换\n\n* “将‘Hello World’从 UTF-8 格式转换为十六进制格式”\n\n## MCP 提示和资源\n\nBSV MCP 服务器提供专门的提示和资源，提供有关比特币 SV 技术的详细信息和背景。人工智能模型可以访问这些信息，以增强其理解力和能力。\n\n### 可用提示\n\n服务器提供以下教育提示，可通过 MCP 协议直接访问：\n\n#### 序数词提示\n\n* **标识符**： `bitcoin_sv_ordinals`\n* **描述**：有关比特币 SV 序数的全面信息，包括它们是什么、如何工作以及如何使用它们。\n* **使用方法**：向助手询问“比特币 SV 序数”或“1Sat 序数”以获取此信息。\n\n#### BSV SDK提示\n\n提供有关 Bitcoin SV SDK 详细信息的提示集合：\n\n* **概述**\n\n * **标识符**： `bitcoin_sv_sdk_overview`\n * **描述**：Bitcoin SV SDK 的概述，包括其用途和主要组件。\n * **用法**：“告诉我有关 BSV SDK 的信息”或“什么是比特币 SV SDK？”\n\n* **钱包操作**\n\n * **标识符**： `bitcoin_sv_sdk_wallet`\n * **描述**：有关 BSV SDK 中的钱包操作的信息。\n * **用法**：“钱包操作如何在 BSV SDK 中工作？”\n\n* **交易大楼**\n\n * **标识符**： `bitcoin_sv_sdk_transaction`\n * **描述**：有关交易创建和操作的详细信息。\n * **用法**：“解释 BSV SDK 交易构建”或“如何使用 BSV SDK 创建交易？”\n\n* **验证**\n\n * **标识符**： `bitcoin_sv_sdk_auth`\n * **描述**：BSV SDK 中的身份验证和身份协议。\n * **用法**：“BSV SDK 如何使用身份验证？”\n\n* **密码学**\n\n * **标识符**： `bitcoin_sv_sdk_cryptography`\n * **描述**：签名、加密和验证功能。\n * **用法**：“解释 BSV SDK 加密功能”\n\n* **脚本**\n\n * **标识符**： `bitcoin_sv_sdk_script`\n * **描述**：比特币脚本和合约功能。\n * **用法**：“如何使用 BSV SDK 处理比特币脚本？”\n\n* **原语**\n\n * **标识符**： `bitcoin_sv_sdk_primitives`\n * **描述**：BSV SDK 中的核心数据类型和结构。\n * **用法**：“BSV SDK 中有哪些原语可用？”\n\n### 可用资源\n\n该服务器还提供对比特币征求意见稿（BRC）规范和文档的访问：\n\n#### 变更日志资源\n\n* **标识符**： `bsv-mcp-changelog`\n* **描述**：BSV MCP 服务器的版本历史和更新日志。\n* **用法**：“向我展示 BSV MCP 更新日志”或“最新版本有什么新内容？”\n\n#### BRC 资源\n\n* **BRC 概览**\n\n * **标识符**： `brcs_readme`\n * **描述**：BRC 存储库中所有 Bitcoin SV 协议规范的概述。\n * **用法**：“向我展示比特币 SV BRC 概览”\n\n* **BRC 摘要**\n\n * **标识符**： `brcs_summary`\n * **描述**：所有比特币 SV BRC 的目录。\n * **用途**：“请给我一份比特币 SV BRC 的摘要”\n\n* **具体的BRC规范**\n\n * **标识符**： `brc_spec`\n * **描述**：按类别和编号访问特定的 BRC 规范。\n * **用法**：“向我展示交易信封上的 BRC 8”或“BRC 1 指定什么？”\n\n#### BRC类别\n\nBRC 规范分为以下类别：\n\n* 钱包\n* 交易\n* 脚本\n* 代币\n* 叠加层\n* 付款\n* 点对点\n* 密钥派生\n* 出站点\n* 观点\n* 状态机\n* 应用程序\n\n### 使用提示和资源\n\nAI 模型可以利用这些提示和资源，提供关于比特币 SV 技术的更准确、更详细的答案。作为用户，您可以：\n\n1. **询问特定主题**：“告诉我有关比特币 SV 序数的信息”或“解释 BSV SDK 交易构建”\n2. **请求具体的 BRC 详细信息**：“BRC 8 指定了什么？”或“向我显示交易创建时的 BRC”\n3. **获取概述**：“什么是 BSV SDK？”或“显示所有 BRC 的摘要”\n\n这些提示和资源增强了人工智能的知识库，即使对于复杂的比特币 SV 主题也能做出更技术性和更准确的反应。\n\n## MCP 的工作原理\n\n当您与支持 MCP 的 AI 助手互动时：\n\n1. 人工智能会分析你的请求并决定使用哪些工具\n2. 经您批准后，它会调用适当的 BSV MCP 工具\n3. 服务器在 Bitcoin SV 区块链上执行请求的操作\n4. 结果返回给AI助手\n5. 助手以自然、对话的方式呈现信息\n\n## 自定义选项\n\n可以使用环境变量定制 BSV MCP 服务器以启用或禁用特定组件：\n\n### 组件配置\n\n| 环境变量 | 默认 | 描述 |\n| ------------------- | ------- | -------------------------- |\n| `DISABLE_PROMPTS` | `false` | 设置为`true`以禁用所有教育提示 |\n| `DISABLE_RESOURCES` | `false` | 设置为`true`以禁用所有资源（BRC、变更日志） |\n| `DISABLE_TOOLS` | `false` | 设置为`true`以禁用所有工具 |\n\n### 特定工具配置\n\n| 环境变量 | 默认 | 描述 |\n| ------------------------ | --------- | ------------------------------------------------------------- |\n| `DISABLE_WALLET_TOOLS` | `false` | 设置为`true`以禁用比特币钱包工具 |\n| `DISABLE_MNEE_TOOLS` | `false` | 设置为`true`以禁用 MNEE 令牌工具 |\n| `DISABLE_BSV_TOOLS` | `false` | 设置为`true`以禁用 BSV 区块链工具 |\n| `DISABLE_ORDINALS_TOOLS` | `false` | 设置为`true`以禁用 Ordinals/NFT 工具 |\n| `DISABLE_UTILS_TOOLS` | `false` | 设置为`true`以禁用实用工具 |\n| `IDENTITY_KEY_WIF` | `not set` | 可选的身份密钥 WIF；如果设置，序数铭文将使用 sigma-protocol 进行签名，以进行身份验证、管理和信任网络。 |\n| `DISABLE_BROADCASTING` | `false` | 设置为`true`以禁用交易广播；返回原始交易十六进制 - 对于广播前的测试和交易审查很有用 |\n\n### 示例\n\n仅使用教育资源和提示运行，无需工具：\n\n```bash\nDISABLE_TOOLS=true bunx bsv-mcp@latest\n```\n\n仅使用 BSV 工具运行，没有钱包或其他功能：\n\n```bash\nDISABLE_PROMPTS=true DISABLE_RESOURCES=true DISABLE_WALLET_TOOLS=true DISABLE_MNEE_TOOLS=true DISABLE_ORDINALS_TOOLS=true DISABLE_UTILS_TOOLS=true bunx bsv-mcp@latest\n```\n\n使用除钱包操作之外的所有工具：\n\n```bash\nDISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest\n```\n\n创建交易但不广播它们（试运行模式）：\n\n```bash\nDISABLE_BROADCASTING=true bunx bsv-mcp@latest\n```\n\n## 故障排除\n\n如果您在使用 BSV MCP 服务器时遇到问题：\n\n### 连接问题\n\n1. 确保你的系统上安装了 Bun 或 Node.js\n2. 验证您的 WIF 私钥是否在环境中正确设置\n3. 检查您的客户端是否支持 MCP 并且已正确配置\n4. 在客户端的控制台输出中查找错误消息\n\n### 保持 Bun 最新状态\n\n保持 Bun 更新到最新版本以确保兼容性非常重要：\n\n```bash\n# Update Bun to the latest version\nbun upgrade\n```\n\n要验证您当前的 Bun 版本：\n\n```bash\nbun --version\n```\n\n### 日志记录和调试\n\n对于 Claude for Desktop，请检查以下日志：\n\n```bash\n# macOS/Linux\ntail -n 20 -f ~/Library/Logs/Claude/mcp*.log\n\n# Windows\ntype %APPDATA%\\Claude\\Logs\\mcp*.log\n```\n\n对于 Cursor，请检查设置 → 扩展 → 模型上下文协议中的 Cursor MCP 日志。\n\n## 最近更新\n\n* **交易广播控制**：添加了`DISABLE_BROADCASTING`环境变量，以防止交易被广播到网络\n* **区块链浏览器**：添加了`bsv_explore`工具，用于访问 WhatsOnChain API 并支持主网/测试网\n* **统一工具**：将`wallet_encrypt` / `wallet_decrypt`合并为单个`wallet_encryption`工具\n* **增强市场**：支持 NFT、BSV-20/21 代币的上架、销售和购买\n* **性能**：添加价格缓存并优化 API 端点结构\n* **改进的验证**：更好地处理私钥和参数的错误\n\n## 比特币SV区块链浏览器\n\n`bsv_explore`工具通过 WhatsOnChain API 提供对比特币 SV 区块链的全面访问。这款强大的浏览器工具允许您查询区块链的各个方面，包括链数据、区块、交易和地址信息。\n\n### 可用端点\n\n该工具支持以下端点类别和特定端点：\n\n#### 链数据\n\n| 端点 | 描述 | 必需参数 | 示例响应 |\n| -------------------- | ------------ | ---- | ----------------------------------------------------------------------------------- |\n| `chain_info` | 网络统计、难度和链工作 | 没有任何 | `{\"chain\":\"main\",\"blocks\":826458,\"headers\":826458,\"bestblockhash\":\"0000000000...\"}` |\n| `chain_tips` | 当前链提示包括高度和状态 | 没有任何 | `[{\"height\":826458,\"hash\":\"000000000000...\",\"branchlen\":0,\"status\":\"active\"}]` |\n| `circulating_supply` | BSV 当前流通供应量 | 没有任何 | `{\"bsv\":21000000}` |\n| `peer_info` | 已连接对等点统计信息 | 没有任何 | `[{\"addr\":\"1.2.3.4:8333\",\"services\":\"000000000000...\",\"lastsend\":1621234567}]` |\n\n#### 区块数据\n\n| 端点 | 描述 | 必需参数 | 示例响应 |\n| --------------------- | ------------ | ----------------------------- | -------------------------------------------------------------------------- |\n| `block_by_hash` | 通过哈希完成区块数据 | `blockHash` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `block_by_height` | 通过高度完成区块数据 | `blockHeight` | `{\"hash\":\"000000000000...\",\"confirmations\":1000,\"size\":1000000,...}` |\n| `tag_count_by_height` | 特定区块的标签计数统计 | `blockHeight` | `{\"tags\":{\"amp\":3,\"bitkey\":5,\"metanet\":12,\"planaria\":7,\"b\":120}}` |\n| `block_headers` | 检索最后 10 个区块头 | 没有任何 | `[{\"hash\":\"000000000000...\",\"height\":826458,\"version\":536870912,...},...]` |\n| `block_pages` | 检索大块的交易 ID 页 | `blockHash` ，可选： `pageNumber` | `[\"tx1hash\",\"tx2hash\",\"tx3hash\",...]` |\n\n#### 统计数据\n\n| 端点 | 描述 | 必需参数 | 示例响应 |\n| ----------------------- | ------------ | ----------------- | -------------------------------------------------------------------------------------- |\n| `block_stats_by_height` | 特定高度的区块统计信息 | `blockHeight` | `{\"size\":123456,\"txCount\":512,\"outputTotal\":54.12345678,\"outputTotalUsd\":2345.67,...}` |\n| `block_miner_stats` | 一段时间内的区块挖矿统计 | 可选： `days` （默认 7） | `{\"blocks\":{\"miner1\":412,\"miner2\":208,...},\"total\":1008}` |\n| `miner_summary_stats` | 采矿统计数据摘要 | 可选： `days` （默认 7） | `{\"totalBlocks\":1008,\"totalFees\":1.23456789,\"totalFeesUsd\":53.67,...}` |\n\n#### 交易数据\n\n| 端点 | 描述 | 必需参数 | 示例响应 |\n| ----------------- | ------------ | ------------ | ------------------------------------------------------------------------------------------ |\n| `tx_by_hash` | 详细交易数据 | `txHash` | `{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,\"locktime\":0,\"size\":225,...}` |\n| `tx_raw` | 原始交易十六进制数据 | `txHash` | `\"01000000012345abcdef...\"` |\n| `tx_receipt` | 交易收据 | `txHash` | `{\"blockHash\":\"000000000000...\",\"blockHeight\":800000,\"confirmations\":26458}` |\n| `bulk_tx_details` | 在一个请求中检索多个交易 | `txids` （数组） | `[{\"txid\":\"a1b2c3d4e5f6...\",\"version\":1,...}, {\"txid\":\"b2c3d4e5f6a7...\",\"version\":1,...}]` |\n\n#### 地址数据\n\n| 端点 | 描述 | 必需参数 | 示例响应 |\n| ----------------- | --------- | ---------------------- | --------------------------------------------------------------- |\n| `address_history` | 地址的交易历史记录 | `address` ，可选： `limit` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"height\":800000},...]` |\n| `address_utxos` | 地址的未使用输出 | `address` | `[{\"tx_hash\":\"a1b2c3d4e5f6...\",\"tx_pos\":0,\"value\":100000},...]` |\n\n#### 网络\n\n| 端点 | 描述 | 必需参数 | 示例响应 |\n| -------- | -------- | ---- | --------------------- |\n| `health` | API 健康检查 | 没有任何 | `{\"status\":\"synced\"}` |\n\n### 使用示例\n\n`bsv_explore`工具可以与自然语言提示一起使用，例如：\n\n```\n\"Get the current Bitcoin SV blockchain information\"\n\"Show me block #800000 details\"\n\"Get tag count statistics for block #800000\"\n\"Fetch transaction history for address 1ExampleBsvAddressXXXXXXXX\"\n\"Get unspent outputs for my wallet address\"\n\"Check transaction details for txid a1b2c3d4e5f6...\"\n\"What is the current BSV circulating supply?\"\n\"Show me the latest block headers\"\n\"Get transaction IDs for page 2 of a large block\"\n\"Show me block statistics for height 800000\"\n\"What are the mining statistics for the last 14 days?\"\n\"Get a summary of mining activity over the past 30 days\"\n\"Retrieve details for multiple transactions in a single query\"\n```\n\n在底层，该工具接受参数来指定要检索的数据：\n\n* `endpoint` ：要查询的特定 WhatsOnChain 端点（例如， `chain_info` ， `tx_by_hash` ）\n* `network` ：要使用的 BSV 网络（ `main`或`test`网络）\n* 特定端点所需的附加参数：\n * `blockHash` ：用于 block\\_by\\_hash 和 block\\_pages 端点\n * `blockHeight` ：用于 block\\_by\\_height、tag\\_count\\_by\\_height 和 block\\_stats\\_by\\_height 端点\n * `pageNumber` ：用于 block\\_pages 端点（分页）\n * `days` ：对于 block\\_miner\\_stats 和 miner\\_summary\\_stats 端点（默认为 7）\n * `txHash` ：用于与交易相关的端点（tx\\_by\\_hash、tx\\_raw、tx\\_receipt）\n * `txids` ：用于 bulk\\_tx\\_details 端点（交易 ID 数组）\n * `address` ：用于与地址相关的端点\n * `limit` ：address\\_history 的可选分页限制\n\n### 网络选项\n\n该工具支持主网和测试网：\n\n* `main` ：比特币 SV 主网（默认）\n* `test` ：比特币SV测试网\n\n# 发展\n\n## 项目设置\n\n如果您想为该项目做出贡献或在本地运行它：\n\n1. 克隆存储库：\n\n ```bash\n git clone https://github.com/b-open-io/bsv-mcp.git\n cd bsv-mcp\n ```\n\n2. 安装依赖项：\n\n ```bash\n bun install\n # or with npm\n npm install\n ```\n\n## 运行服务器\n\n```bash\nbun run index.ts\n# or with npm\nnpm run start\n```\n\n### 运行测试\n\n```bash\nbun test\n# or with npm\nnpm test\n```\n\n## 执照\n\n该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅[LICENSE](LICENSE)文件。","Chinese","zh-CN","githubUser","locale",{"_72":73,"_13":74,"_83":32,"_84":32,"_33":34,"_16":85,"_86":87,"_106":107,"_114":-5,"_115":116,"_117":118,"_119":120,"_202":203,"_208":-5,"_94":180,"_209":210,"_97":211,"_212":213},"addedAt","2025-04-16T16:02:58.385409Z",[75,76,77,78,79,80,81,82],"category:blockchain","category:web3","category:other","environment:network","hosting:remote-capable","language:typescript","security_grade:a","quality_grade:a","descriptionMarkdown","descriptionPlainText",5552,"integrations",[88,99],{"_89":90,"_31":96,"_97":98},"brand",{"_91":92,"_37":93,"_94":95},"logoSvgPath","M14.648 14.423l.003-.004a1.34 1.34 0 0 1-.498.659c-.269.189-.647.338-1.188.364l-1.99.004v-2.93c.288.008 1.565-.013 2.119.015.722.035 1.171.321 1.41.668.262.351.293.82.144 1.224zm-2.129-3.261c.503-.024.852-.162 1.101-.336.214-.146.375-.367.46-.611.134-.375.107-.81-.136-1.135-.223-.319-.638-.584-1.306-.616-.495-.026-1.413-.003-1.664-.01v2.709c.025.004 1.539-.001 1.545-.001zM24 12c0 6.627-5.373 12-12 12S0 18.627 0 12 5.373 0 12 0s12 5.373 12 12zm-6.65 2.142c.022-1.477-1.24-2.332-1.908-2.572.715-.491 1.206-1.043 1.206-2.085 0-1.655-1.646-2.43-2.647-2.529-.082-.009-.31-.013-.31-.013V5.361h-1.633l.004 1.583H10.97V5.367H9.31v1.569c-.292.007-2.049.006-2.049.006v1.401h.571c.601.016.822.362.798.677v6.041a.408.408 0 0 1-.371.391c-.249.011-.621 0-.621 0l-.32 1.588h1.996v1.6h1.661v-1.591h1.091v1.594h1.624v-1.588c1.899.05 3.643-1.071 3.66-2.913z","Bitcoin SV","slug","bitcoinsv","Provides wallet functionality, BSV blockchain interaction, ordinals/NFT management, and utility tools for Bitcoin SV. Capabilities include retrieving addresses, sending transactions, purchasing NFTs, getting price information, working with ordinals, and managing BSV20 tokens.","uid","xxls2puv5t",{"_89":100,"_31":104,"_97":105},{"_91":101,"_37":102,"_94":103},"M12 22.596c6.628 0 12-4.338 12-9.688 0-3.318-2.057-6.248-5.219-7.986-1.286-.715-2.297-1.357-3.139-1.89C14.058 2.025 13.08 1.404 12 1.404c-1.097 0-2.334.785-3.966 1.821a49.92 49.92 0 0 1-2.816 1.697C2.057 6.66 0 9.59 0 12.908c0 5.35 5.372 9.687 12 9.687v.001ZM10.599 4.715c.334-.759.503-1.58.498-2.409 0-.145.202-.187.23-.029.658 2.783-.902 4.162-2.057 4.624-.124.048-.199-.121-.103-.209a5.763 5.763 0 0 0 1.432-1.977Zm2.058-.102a5.82 5.82 0 0 0-.782-2.306v-.016c-.069-.123.086-.263.185-.172 1.962 2.111 1.307 4.067.556 5.051-.082.103-.23-.003-.189-.126a5.85 5.85 0 0 0 .23-2.431Zm1.776-.561a5.727 5.727 0 0 0-1.612-1.806v-.014c-.112-.085-.024-.274.114-.218 2.595 1.087 2.774 3.18 2.459 4.407a.116.116 0 0 1-.049.071.11.11 0 0 1-.153-.026.122.122 0 0 1-.022-.083 5.891 5.891 0 0 0-.737-2.331Zm-5.087.561c-.617.546-1.282.76-2.063 1-.117 0-.195-.078-.156-.181 1.752-.909 2.376-1.649 2.999-2.778 0 0 .155-.118.188.085 0 .304-.349 1.329-.968 1.874Zm4.945 11.237a2.957 2.957 0 0 1-.937 1.553c-.346.346-.8.565-1.286.62a2.178 2.178 0 0 1-1.327-.62 2.955 2.955 0 0 1-.925-1.553.244.244 0 0 1 .064-.198.234.234 0 0 1 .193-.069h3.965a.226.226 0 0 1 .19.07c.05.053.073.125.063.197Zm-5.458-2.176a1.862 1.862 0 0 1-2.384-.245 1.98 1.98 0 0 1-.233-2.447c.207-.319.503-.566.848-.713a1.84 1.84 0 0 1 1.092-.11c.366.075.703.261.967.531a1.98 1.98 0 0 1 .408 2.114 1.931 1.931 0 0 1-.698.869v.001Zm8.495.005a1.86 1.86 0 0 1-2.381-.253 1.964 1.964 0 0 1-.547-1.366c0-.384.11-.76.32-1.079.207-.319.503-.567.849-.713a1.844 1.844 0 0 1 1.093-.108c.367.076.704.262.968.534a1.98 1.98 0 0 1 .4 2.117 1.932 1.932 0 0 1-.702.868Z","Bun","bun","Uses Bun as the JavaScript runtime for the MCP server, enabling fast execution of the Bitcoin SV tools and capabilities.","x7f1pxmbtu","namespace",{"_108":109,"_94":113},"owner",{"_110":111},"githubAccount",{"_112":113},"login","b-open-io","readmeMarkdown","recentUsage",0,"redditPostExternalId","1ntc6u9","repository",{"_121":122,"_165":166,"_169":170,"_190":-5,"_191":192,"_193":194,"_197":198},"argumentsJsonSchema",{"_123":124,"_162":163,"_130":164},"properties",{"_125":126,"_132":133,"_135":136,"_138":139,"_141":142,"_144":145,"_147":148,"_150":151,"_153":154,"_156":157,"_159":160},"DISABLE_TOOLS",{"_127":128,"_31":129,"_130":131},"default","false","Set to true to disable all tools","type","string","DISABLE_PROMPTS",{"_127":128,"_31":134,"_130":131},"Set to true to disable all educational prompts","PRIVATE_KEY_WIF",{"_31":137,"_130":131},"Your private key in WIF format for Bitcoin wallet operations","IDENTITY_KEY_WIF",{"_31":140,"_130":131},"Optional WIF for identity key; if set, ordinals inscriptions will be signed with sigma-protocol for authentication, curation, and web-of-trust","DISABLE_BSV_TOOLS",{"_127":128,"_31":143,"_130":131},"Set to true to disable BSV blockchain tools","DISABLE_RESOURCES",{"_127":128,"_31":146,"_130":131},"Set to true to disable all resources (BRCs, changelog)","DISABLE_MNEE_TOOLS",{"_127":128,"_31":149,"_130":131},"Set to true to disable MNEE token tools","DISABLE_UTILS_TOOLS",{"_127":128,"_31":152,"_130":131},"Set to true to disable utility tools","DISABLE_BROADCASTING",{"_127":128,"_31":155,"_130":131},"Set to true to disable transaction broadcasting; returns raw transaction hex instead - useful for testing and transaction review before broadcasting","DISABLE_WALLET_TOOLS",{"_127":128,"_31":158,"_130":131},"Set to true to disable Bitcoin wallet tools","DISABLE_ORDINALS_TOOLS",{"_127":128,"_31":161,"_130":131},"Set to true to disable Ordinals/NFT tools","required",[],"object","githubProject",{"_35":36,"_167":168},"url","https://github.com/b-open-io/bsv-mcp","githubRepository",{"_171":172,"_173":174,"_175":176,"_16":177,"_178":179,"_37":180,"_108":181,"_183":184,"_185":186,"_188":189},"defaultBranch","master","fullName","b-open-io/bsv-mcp","githubTreeId",2533434,10266,"language","TypeScript","bsv-mcp",{"_112":113,"_97":182},"kxUTxlpUay","recentStargazers",1,"spdxLicense",{"_37":187},"MIT License","stargazers",15,"glamaJson","inspectable",true,"npmPackage",{"_37":180,"_195":196},"weeklyDownloads",16,"supportedPlatforms",[199,200,201],"MACOS","WINDOWS","LINUX","scores",{"_204":-5,"_205":206,"_207":206},"license","quality",100,"security","simpleIcon","toolCount",9,"2tjvjasfmo","updatedAt","2025-10-01T14:52:25.452609Z","meta",[216,219,221,228,231,233,236,239,242,245,248,250,253,256,258,260,262,264,266],{"_217":218},"title","Bitcoin SV MCP Server | Glama",{"_220":32,"_37":31},"content",{"_222":223,"_224":225,"_226":227},"href","https://glama.ai/mcp/servers/@b-open-io/bsv-mcp","rel","canonical","tagName","link",{"_220":34,"_229":230},"property","og:title",{"_220":32,"_229":232},"og:description",{"_220":234,"_229":235},"https://glama.ai/logo.png","og:logo",{"_220":237,"_229":238},"https://glama.ai/mcp/servers/@b-open-io/bsv-mcp/og-image","og:image",{"_220":240,"_229":241},"630","og:image:height",{"_220":243,"_229":244},"1200","og:image:width",{"_220":246,"_229":247},"website","og:type",{"_220":223,"_229":249},"og:url",{"_220":251,"_229":252},"Glama – MCP Hosting Platform","og:site_name",{"_220":254,"_37":255},"summary_large_image","twitter:card",{"_220":251,"_37":257},"twitter:title",{"_220":32,"_37":259},"twitter:description",{"_220":237,"_37":261},"twitter:image",{"_220":240,"_37":263},"twitter:image:height",{"_220":243,"_37":265},"twitter:image:width",{"_267":268},"script:ld+json",{"_269":270,"_271":272},"@context","http://schema.org","@graph",[273],{"_269":274,"_275":276,"_277":278},"https://schema.org","@type","BreadcrumbList","itemListElement",[279,285,288,292],{"_275":280,"_281":282,"_37":283,"_284":184},"ListItem","item","https://glama.ai/","Glama","position",{"_275":280,"_281":286,"_37":287,"_284":22},"https://glama.ai/mcp","MCP",{"_275":280,"_281":289,"_37":290,"_284":291},"https://glama.ai/mcp/servers","Servers",3,{"_275":280,"_281":223,"_37":34,"_284":293},4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_298":299,"_29":305,"_337":338,"_214":349,"_347":373,"_374":375},"blob",{"_220":300,"_301":302,"_303":304},"FROM oven/bun:1.2.12\n\nWORKDIR /app\n\nCOPY package.json bun.lock ./\nRUN --mount=type=cache,target=/root/.bun bun install --frozen-lockfile\n\nCOPY . .\n\nUSER bun\n\nEXPOSE 3000\n\nCMD [\"bun\", \"run\", \"index.ts\"]","fileName","Dockerfile","size",201,{"_72":73,"_13":306,"_83":32,"_84":32,"_33":34,"_16":85,"_86":307,"_106":312,"_114":-5,"_115":116,"_117":118,"_119":315,"_202":336,"_208":-5,"_94":180,"_209":210,"_97":211,"_212":213},[75,76,77,78,79,80,81,82],[308,310],{"_89":309,"_31":96,"_97":98},{"_91":92,"_37":93,"_94":95},{"_89":311,"_31":104,"_97":105},{"_91":101,"_37":102,"_94":103},{"_108":313,"_94":113},{"_110":314},{"_112":113},{"_121":316,"_165":330,"_169":331,"_190":-5,"_191":192,"_193":334,"_197":335},{"_123":317,"_162":329,"_130":164},{"_125":318,"_132":319,"_135":320,"_138":321,"_141":322,"_144":323,"_147":324,"_150":325,"_153":326,"_156":327,"_159":328},{"_127":128,"_31":129,"_130":131},{"_127":128,"_31":134,"_130":131},{"_31":137,"_130":131},{"_31":140,"_130":131},{"_127":128,"_31":143,"_130":131},{"_127":128,"_31":146,"_130":131},{"_127":128,"_31":149,"_130":131},{"_127":128,"_31":152,"_130":131},{"_127":128,"_31":155,"_130":131},{"_127":128,"_31":158,"_130":131},{"_127":128,"_31":161,"_130":131},[],{"_35":36,"_167":168},{"_171":172,"_173":174,"_175":176,"_16":177,"_178":179,"_37":180,"_108":332,"_183":184,"_185":333,"_188":189},{"_112":113,"_97":182},{"_37":187},{"_37":180,"_195":196},[199,200,201],{"_204":-5,"_205":206,"_207":206},"member",{"_339":340,"_343":344,"_345":302,"_175":176,"_346":295,"_347":302,"_348":192,"_303":304,"_130":298},"commit",{"_341":342},"sha","dfac09ea79de2314faf9b5b5b8bf12cc01caee6c","contentStoredObjectPointerId",18678745,"fullPath","indexable","path","safeToDisplayAsText",[350,352,354,356,358,359,360,362,363,364,365,366,367,368,369,370,371,372],{"_217":351},"Dockerfile | Bitcoin SV MCP Server | Glama",{"_220":353,"_37":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_222":355,"_224":225,"_226":227},"https://glama.ai/mcp/servers/@b-open-io/bsv-mcp/blob/dfac09ea79de2314faf9b5b5b8bf12cc01caee6c/",{"_220":357,"_229":230},"Dockerfile | Bitcoin SV MCP Server",{"_220":353,"_229":232},{"_220":234,"_229":235},{"_220":361,"_229":238},"https://glama.ai/generated-images/og?title=Dockerfile+%7C+Bitcoin+SV+MCP+Server",{"_220":240,"_229":241},{"_220":243,"_229":244},{"_220":246,"_229":247},{"_220":355,"_229":249},{"_220":251,"_229":252},{"_220":254,"_37":255},{"_220":251,"_37":257},{"_220":353,"_37":259},{"_220":361,"_37":261},{"_220":240,"_37":263},{"_220":243,"_37":265},"","treeMembers",[376,380,383,386,389,392,395,398,401,404,407,410,413,416,419,422,424,427,430,433,436,439,442,445,448,451,454,457,460,463,466],{"_339":377,"_345":378,"_347":378,"_130":379},{"_341":342},"app","tree",{"_339":381,"_345":382,"_347":382,"_130":379},{"_341":342},"components",{"_339":384,"_345":385,"_347":385,"_130":379},{"_341":342},"docs",{"_339":387,"_345":388,"_347":388,"_130":379},{"_341":342},"lib",{"_339":390,"_345":391,"_347":391,"_130":379},{"_341":342},".next",{"_339":393,"_345":394,"_347":394,"_130":379},{"_341":342},"prompts",{"_339":396,"_345":397,"_347":397,"_130":379},{"_341":342},"resources",{"_339":399,"_345":400,"_347":400,"_130":379},{"_341":342},"tools",{"_339":402,"_345":403,"_347":403,"_130":379},{"_341":342},"transports",{"_339":405,"_345":406,"_347":406,"_130":379},{"_341":342},"utils",{"_339":408,"_345":409,"_347":409,"_130":298},{"_341":342},"biome.json",{"_339":411,"_345":412,"_347":412,"_130":298},{"_341":342},"bun.lock",{"_339":414,"_345":415,"_347":415,"_130":298},{"_341":342},"bun.lock.next",{"_339":417,"_345":418,"_347":418,"_130":298},{"_341":342},"CHANGELOG.md",{"_339":420,"_345":421,"_347":421,"_130":298},{"_341":342},"CLAUDE.md",{"_339":423,"_345":302,"_347":302,"_130":298},{"_341":342},{"_339":425,"_345":426,"_347":426,"_130":298},{"_341":342},".env.example",{"_339":428,"_345":429,"_347":429,"_130":298},{"_341":342},".gitignore",{"_339":431,"_345":432,"_347":432,"_130":298},{"_341":342},"HOSTED.md",{"_339":434,"_345":435,"_347":435,"_130":298},{"_341":342},"index.ts",{"_339":437,"_345":438,"_347":438,"_130":298},{"_341":342},"LICENSE",{"_339":440,"_345":441,"_347":441,"_130":298},{"_341":342},".mcp.json",{"_339":443,"_345":444,"_347":444,"_130":298},{"_341":342},"next.config.mjs",{"_339":446,"_345":447,"_347":447,"_130":298},{"_341":342},"next-env.d.ts",{"_339":449,"_345":450,"_347":450,"_130":298},{"_341":342},"package.json",{"_339":452,"_345":453,"_347":453,"_130":298},{"_341":342},"package.next.json",{"_339":455,"_345":456,"_347":456,"_130":298},{"_341":342},"README.md",{"_339":458,"_345":459,"_347":459,"_130":298},{"_341":342},"smithery.yaml",{"_339":461,"_345":462,"_347":462,"_130":298},{"_341":342},"tsconfig.json",{"_339":464,"_345":465,"_347":465,"_130":298},{"_341":342},"tsconfig.mcp.json",{"_339":467,"_345":468,"_347":468,"_130":298},{"_341":342},"vercel.json","actionData","errors"]

MCP directory API