bsv-mcp 0.0.35 → 0.2.0

package/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "bsv-mcp",
-	"module": "index.ts",
+	"module": "dist/index.js",
 	"type": "module",
-	"version": "0.0.35",
+	"version": "0.2.0",
 	"license": "MIT",
 	"author": "satchmo",
 	"description": "A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework",
@@ -22,6 +22,7 @@
 		"block explorer"
 	],
 	"files": [
+		"dist/**/*.js",
 		"package.json",
 		"*.ts",
 		"tools/*.ts",
@@ -36,28 +37,69 @@
 		"smithery.yaml"
 	],
 	"bin": {
-		"bsv-mcp": "./index.ts"
+		"bsv-mcp": "./dist/index.js"
 	},
 	"private": false,
 	"devDependencies": {
-		"@biomejs/biome": "^1.9.4",
-		"@types/bun": "latest"
+		"@biomejs/biome": "^2.4.6",
+		"@tailwindcss/postcss": "^4.2.1",
+		"@types/bun": "^1.3.10",
+		"@types/node": "^25.3.5",
+		"bun": "^1.3.10",
+		"@types/react": "^19.2.14",
+		"@types/react-dom": "^19.2.3",
+		"autoprefixer": "^10.4.27",
+		"postcss": "^8.5.8",
+		"tailwindcss": "^4.2.1",
+		"tailwindcss-animate": "^1.0.7"
 	},
 	"peerDependencies": {
-		"typescript": "^5.8.3"
+		"typescript": "^5.9.3"
 	},
 	"dependencies": {
-		"@bsv/sdk": "^1.4.20",
-		"@modelcontextprotocol/sdk": "^1.10.2",
-		"@types/node": "^22.14.1",
-		"js-1sat-ord": "^0.1.81",
-		"mnee": "^2.0.0",
-		"satoshi-token": "^0.0.4",
-		"sigma-protocol": "^0.1.6",
-		"zod": "^3.24.3"
+		"@bsv/sdk": "^2.0.6",
+		"@modelcontextprotocol/sdk": "^1.27.1",
+		"@radix-ui/react-dialog": "^1.1.15",
+		"@radix-ui/react-dropdown-menu": "^2.1.16",
+		"@radix-ui/react-label": "^2.1.8",
+		"@radix-ui/react-separator": "^1.1.8",
+		"@radix-ui/react-slot": "^1.2.4",
+		"@radix-ui/react-tabs": "^1.1.13",
+		"@radix-ui/react-toast": "^1.2.15",
+		"@radix-ui/react-tooltip": "^1.2.8",
+		"@radix-ui/themes": "^3.3.0",
+		"@tanstack/react-query": "^5.90.21",
+		"bigblocks": "0.0.39",
+		"bitcoin-auth": "^0.0.7",
+		"bitcoin-backup": "0.0.7",
+		"bmap-api-types": "0.0.9",
+		"bsv-bap": "0.1.23",
+		"class-variance-authority": "^0.7.1",
+		"clsx": "^2.1.1",
+		"jose": "^6.2.0",
+		"js-1sat-ord": "^0.1.91",
+		"lucide-react": "0.577.0",
+		"mcp-handler": "^1.0.7",
+		"mnee": "^3.1.0",
+		"next": "^16.1.6",
+		"next-themes": "^0.4.6",
+		"react": "^19.2.4",
+		"react-dom": "^19.2.4",
+		"satoshi-token": "^0.0.7",
+		"schema-dts": "^1.1.5",
+		"sigma-protocol": "^0.1.9",
+		"sonner": "^2.0.7",
+		"tailwind-merge": "^3.5.0",
+		"zod": "^4.3.6"
 	},
 	"scripts": {
+		"build": "bun build ./index.ts --outdir ./dist --target node",
+		"dev": "next dev",
+		"build:next": "next build",
+		"start:next": "next start",
 		"lint": "biome check .",
-		"lint:fix": "biome check . --write"
+		"lint:fix": "biome check . --write",
+		"deploy": "vercel --prod",
+		"deploy:preview": "vercel"
 	}
 }

package/prompts/bsvSdk/index.ts

@@ -24,11 +24,11 @@ export function registerAllBsvSdkPrompts(server: McpServer): void {
 	registerPrimitivesPrompt(server);
 }
 
-// Export all prompts
-export { registerOverviewPrompt } from "./overview";
-export { registerWalletPrompt } from "./wallet";
-export { registerTransactionPrompt } from "./transaction";
 export { registerAuthPrompt } from "./auth";
 export { registerCryptographyPrompt } from "./cryptography";
-export { registerScriptPrompt } from "./script";
+// Export all prompts
+export { registerOverviewPrompt } from "./overview";
 export { registerPrimitivesPrompt } from "./primitives";
+export { registerScriptPrompt } from "./script";
+export { registerTransactionPrompt } from "./transaction";
+export { registerWalletPrompt } from "./wallet";

package/prompts/bsvSdk/transaction.ts

@@ -69,7 +69,7 @@ tx.addOutput({
 });
 
 // Add a data (OP_RETURN) output
-const dataScript = LockingScript.fromData(Buffer.from("Hello, Bitcoin!"));
+const dataScript = LockingScript.fromData(Utils.toArray("Hello, Bitcoin!", "utf8"));
 tx.addOutput({
   lockingScript: dataScript,
   satoshis: 0 // OP_RETURN outputs typically have 0 value
@@ -205,7 +205,7 @@ import { Script, OpCodes } from "@bsv/sdk";
 const customScript = new Script();
 customScript.add(OpCodes.OP_DUP);
 customScript.add(OpCodes.OP_HASH160);
-customScript.add(Buffer.from("public_key_hash", "hex"));
+customScript.add(Utils.toArray("public_key_hash", "hex"));
 customScript.add(OpCodes.OP_EQUALVERIFY);
 customScript.add(OpCodes.OP_CHECKSIG);
 

package/prompts/bsvSdk/wallet.ts

@@ -54,7 +54,7 @@ const privateKey = PrivateKey.fromRandom();
 const importedKey = PrivateKey.fromWif("your-wif-string");
 
 // Generate from a seed
-const seedKey = PrivateKey.fromSeed(Buffer.from("your-seed-data"));
+const seedKey = PrivateKey.fromSeed(Utils.toArray("your-seed-data", "utf8"));
 
 // Get the corresponding public key
 const publicKey = privateKey.toPublicKey();

package/prompts/index.ts

@@ -16,8 +16,8 @@ export function registerAllPrompts(server: McpServer): void {
 	// Add more prompts registration here as needed
 }
 
+export * from "./bsvSdk";
 /**
  * Export all prompt constants
  */
 export * from "./ordinals";
-export * from "./bsvSdk";

package/resources/bitcom.ts

@@ -0,0 +1,132 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// Store protocol documentation
+// Source AIP: https://raw.githubusercontent.com/b-open-io/AIP/refs/heads/main/README.md
+// Source MAP: https://raw.githubusercontent.com/rohenaz/MAP/refs/heads/master/README.md
+// Source SIGMA: User provided text
+const bitcomProtocols = {
+	AIP: {
+		name: "Author Identity Protocol (AIP)",
+		prefix: "15PciHG22SNLQJXMoSUaWVi7WSqc7hCfva",
+		description:
+			"A simple and flexible method to sign arbitrary OP_RETURN data with Bitcoin ECDSA signatures, decoupling the signing address from the funding source.",
+		structure: `
+OP_RETURN
+  [Data]
+  [Media Type]
+  [Encoding]
+  [Filename]
+  |
+  15PciHG22SNLQJXMoSUaWVi7WSqc7hCfva (AIP Prefix)
+  [Signing Algorithm] (e.g., BITCOIN_ECDSA)
+  [Signing Address]
+  [Signature] (Base64 Encoded)
+  [Field Index 0] (Optional, 0 = OP_RETURN 0x6a)
+  [Field Index 1] (Optional)
+  ... (If indexes are omitted, all fields left of '|' are signed)
+`,
+		reference:
+			"https://raw.githubusercontent.com/b-open-io/AIP/refs/heads/main/README.md",
+	},
+	MAP: {
+		name: "Magic Attribute Protocol (MAP)",
+		prefix: "1PuQa7K62MiKCtssSLKy1kh56WWU7MtUR5",
+		description:
+			"A simple protocol for associating data in a single transaction by defining key-value pairs, often used for mapping content (like B:// protocol data) to identifiers or actions.",
+		structure: `
+OP_RETURN
+  ... (Optional Input Data Protocol, e.g., B://)
+  |
+  1PuQa7K62MiKCtssSLKy1kh56WWU7MtUR5 (MAP Prefix)
+  'SET'
+  [Key 1] (UTF8 String)
+  [Value 1] (UTF8 String)
+  [Key 2] (Optional UTF8 String)
+  [Value 2] (Optional UTF8 String)
+  ...
+`,
+		notes:
+			"Can be used standalone or chained after other protocols (like B). Keys can represent attributes (url, type, coordinates.lat) or actions (like, follow.user).",
+		reference:
+			"https://raw.githubusercontent.com/rohenaz/MAP/refs/heads/master/README.md",
+	},
+	SIGMA: {
+		name: "Sigma Protocol",
+		prefix: "SIGMA", // As per user text, though often represented by a Bitcom address
+		description:
+			"Enhances transaction security by signing custom output scripts, incorporating input txid and output data hashes to mitigate replay attacks.",
+		structure: `
+<locking script>
+OP_RETURN
+  [Additional Data] (Optional)
+  | (Optional Separator)
+  SIGMA (Protocol Identifier)
+  [Signing Algorithm] (e.g., ECDSA)
+  [Signing Address]
+  [Signature] (Base64 Encoded in lib, Hex in script)
+  [VIN] (Index of input whose txid is included in signature, -1 for corresponding input)
+`,
+		reference: "User provided text (Abstract/Introduction)",
+	},
+	// BAP could be added here if spec is provided
+} as const; // Use 'as const' for stricter type inference
+
+type ProtocolName = keyof typeof bitcomProtocols;
+
+// Define the MCP resource
+const bitcomResourceTemplate = new ResourceTemplate(
+	"bitcom://protocol/{protocolName}",
+	{ list: undefined }, // Required options object with list: undefined
+);
+
+/**
+ * Register the Bitcom protocol documentation resource
+ * @param server McpServer instance
+ */
+export function registerBitcomResource(server: McpServer): void {
+	server.resource(
+		"bitcom_protocol",
+		bitcomResourceTemplate,
+		async (uri, params) => {
+			const protocolName = params.protocolName as ProtocolName;
+
+			if (!protocolName || !(protocolName in bitcomProtocols)) {
+				const available = Object.keys(bitcomProtocols).join(", ");
+				return {
+					code: -32602, // Invalid params
+					message: `Invalid or missing protocol name. Available: ${available}`,
+					contents: [],
+				};
+			}
+
+			const proto = bitcomProtocols[protocolName];
+			const notesString =
+				"notes" in proto && proto.notes ? `\\nNotes:\\n${proto.notes}\\n` : "";
+
+			const textContent = `
+Protocol: ${proto.name}
+Prefix: ${proto.prefix || "N/A"}
+Reference: ${proto.reference}
+
+Description:
+${proto.description}
+
+Structure:
+\`\`\`
+${proto.structure.trim()}
+\`\`\`
+${notesString}      `.trim();
+
+			return {
+				contents: [
+					{
+						uri: uri.href,
+						text: textContent,
+						mimeType: "text/plain",
+					},
+				],
+			};
+		},
+	);
+}

package/resources/resources.ts

@@ -1,7 +1,8 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { registerBRCsResources } from "./brcs";
-import { registerChangelogResource } from "./changelog";
-import { registerJungleBusResource } from "./junglebus";
+import { registerBitcomResource } from "./bitcom.js";
+import { registerBRCsResources } from "./brcs.js";
+import { registerChangelogResource } from "./changelog.js";
+import { registerJungleBusResource } from "./junglebus.js";
 
 /**
  * Register all resources with the MCP server
@@ -17,5 +18,8 @@ export function registerResources(server: McpServer): void {
 	// Register JungleBus API documentation resource
 	registerJungleBusResource(server);
 
+	// Register Bitcom resource
+	registerBitcomResource(server);
+
 	// Add more resource categories here as needed
 }

package/smithery.yaml

@@ -55,6 +55,9 @@ startCommand:
     (config) => {
       const env = {};
       
+      // Set stdio transport for MCP
+      env.TRANSPORT = 'stdio';
+      
       // Add private key if provided
       if (config.privateKeyWif) {
         env.PRIVATE_KEY_WIF = config.privateKeyWif;

package/test-mcp-server.ts

@@ -0,0 +1,157 @@
+#!/usr/bin/env bun
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+async function testMCPServer() {
+	console.log("🧪 Testing BSV MCP Server...\n");
+
+	// Create transport
+	const transport = new StdioClientTransport({
+		command: "bun",
+		args: ["run", "./index.ts"],
+		env: {
+			...process.env,
+			TRANSPORT: "stdio",
+			DISABLE_BROADCASTING: "true", // Don't broadcast test transactions
+			USE_DROPLET_API: "false", // Use local mode to test BSocial
+		},
+	});
+
+	// Create client
+	const client = new Client(
+		{ name: "test-client", version: "1.0.0" },
+		{
+			capabilities: {},
+		},
+	);
+
+	try {
+		// Connect
+		console.log("📡 Connecting to server...");
+		await client.connect(transport);
+		console.log("✅ Connected successfully\n");
+
+		// List available tools
+		console.log("🔧 Available tools:");
+		const tools = await client.listTools();
+		console.log(`Found ${tools.tools.length} tools:`);
+
+		// Group tools by category
+		const categories = new Map<string, string[]>();
+		for (const tool of tools.tools) {
+			const prefix = tool.name.split("_")[0];
+			if (!categories.has(prefix)) {
+				categories.set(prefix, []);
+			}
+			const categoryTools = categories.get(prefix);
+			if (categoryTools) {
+				categoryTools.push(tool.name);
+			}
+		}
+
+		// Display by category
+		for (const [category, toolNames] of categories) {
+			console.log(`\n${category}:`);
+			for (const name of toolNames) {
+				console.log(`  - ${name}`);
+			}
+		}
+
+		// Test a few tools
+		console.log("\n🧪 Testing tools:\n");
+
+		// 1. Test BSV price tool
+		console.log("1. Testing bsv_getPrice:");
+		try {
+			const priceResult = await client.callTool({
+				name: "bsv_getPrice",
+				arguments: {},
+			});
+			const content = priceResult.content[0] as { text: string };
+			console.log("✅", content.text);
+		} catch (error) {
+			console.log("❌ Error:", error);
+		}
+
+		// 2. Test utils conversion
+		console.log("\n2. Testing utils_convertData:");
+		try {
+			const convertResult = await client.callTool({
+				name: "utils_convertData",
+				arguments: {
+					args: {
+						data: "Hello BSV!",
+						from: "utf8",
+						to: "hex",
+					},
+				},
+			});
+			const content = convertResult.content[0] as { text: string };
+			console.log("✅ Converted:", content.text);
+		} catch (error) {
+			console.log("❌ Error:", error);
+		}
+
+		// 3. Test bsocial_readPosts
+		console.log("\n3. Testing bsocial_readPosts:");
+		try {
+			const postsResult = await client.callTool({
+				name: "bsocial_readPosts",
+				arguments: {
+					args: {
+						limit: 5,
+					},
+				},
+			});
+			const content = postsResult.content[0] as { text: string };
+			console.log("✅ Read posts (showing first 200 chars):");
+			console.log(`${content.text.substring(0, 200)}...`);
+		} catch (error) {
+			console.log("❌ Error:", error);
+		}
+
+		// 4. Test ordinals search
+		console.log("\n4. Testing ordinals_searchInscriptions:");
+		try {
+			const ordinalsResult = await client.callTool({
+				name: "ordinals_searchInscriptions",
+				arguments: {
+					args: {
+						query: "test",
+						limit: 3,
+					},
+				},
+			});
+			const content = ordinalsResult.content[0] as { text: string };
+			const response = JSON.parse(content.text);
+			console.log(`✅ Found ${response.total || 0} inscriptions`);
+		} catch (error) {
+			console.log("❌ Error:", error);
+		}
+
+		// List resources
+		console.log("\n📚 Available resources:");
+		const resources = await client.listResources();
+		console.log(`Found ${resources.resources.length} resources`);
+		for (const resource of resources.resources) {
+			console.log(`  - ${resource.name}`);
+		}
+
+		// List prompts
+		console.log("\n💭 Available prompts:");
+		const prompts = await client.listPrompts();
+		console.log(`Found ${prompts.prompts.length} prompts`);
+		for (const prompt of prompts.prompts) {
+			console.log(`  - ${prompt.name}`);
+		}
+	} catch (error) {
+		console.error("❌ Test failed:", error);
+	} finally {
+		console.log("\n🔌 Disconnecting...");
+		await client.close();
+		process.exit(0);
+	}
+}
+
+// Run the test
+testMCPServer().catch(console.error);