bsv-mcp 0.0.25 → 0.0.26

package/README.md

@@ -38,6 +38,8 @@ This server implements the [Model Context Protocol](https://modelcontextprotocol
 
 ![MCP Configuration Example](docs/images/mcp-config-example.png)
 
+> **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.
+
 ### Cursor
 
 To use the BSV MCP server with [Cursor](https://cursor.sh/):
@@ -282,6 +284,11 @@ A collection of prompts providing detailed information about the Bitcoin SV SDK:
 
 The server also provides access to Bitcoin Request for Comments (BRC) specifications and documentation:
 
+#### Changelog Resource
+- **Identifier**: `bsv-mcp-changelog`
+- **Description**: Version history and changelog for the BSV MCP server.
+- **Usage**: "Show me the BSV MCP changelog" or "What's new in the latest version?"
+
 #### BRC Resources
 - **BRCs Overview**
   - **Identifier**: `brcs_readme`
@@ -333,6 +340,49 @@ When you interact with an MCP-enabled AI assistant:
 4. The results are returned to the AI assistant
 5. The assistant presents the information in a natural, conversational way
 
+## Customization Options
+
+The BSV MCP server can be customized using environment variables to enable or disable specific components:
+
+### Component Configuration
+
+| Environment Variable | Default | Description |
+| -------------------- | ------- | ----------- |
+| `DISABLE_PROMPTS` | `false` | Set to `true` to disable all educational prompts |
+| `DISABLE_RESOURCES` | `false` | Set to `true` to disable all resources (BRCs, changelog) |
+| `DISABLE_TOOLS` | `false` | Set to `true` to disable all tools |
+
+### Tool-Specific Configuration
+
+| Environment Variable | Default | Description |
+| -------------------- | ------- | ----------- |
+| `DISABLE_WALLET_TOOLS` | `false` | Set to `true` to disable Bitcoin wallet tools |
+| `DISABLE_MNEE_TOOLS` | `false` | Set to `true` to disable MNEE token tools |
+| `DISABLE_BSV_TOOLS` | `false` | Set to `true` to disable BSV blockchain tools |
+| `DISABLE_ORDINALS_TOOLS` | `false` | Set to `true` to disable Ordinals/NFT tools |
+| `DISABLE_UTILS_TOOLS` | `false` | Set to `true` to disable utility tools |
+| `DISABLE_A2B_TOOLS` | `false` | Set to `true` to disable agent-to-blockchain tools |
+
+### Examples
+
+Run with only educational resources and prompts, no tools:
+
+```bash
+DISABLE_TOOLS=true bunx bsv-mcp@latest
+```
+
+Run with only BSV tools, no wallet or other functionality:
+
+```bash
+DISABLE_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
+```
+
+Use all tools except wallet operations:
+
+```bash
+DISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest
+```
+
 ## Troubleshooting
 
 If you're having issues with the BSV MCP server:
@@ -392,7 +442,7 @@ The tool supports the following endpoint categories and specific endpoints:
 
 | Endpoint             | Description                                     | Required Parameters | Example Response                                                                      |
 | -------------------- | ----------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------- |
-| `chain_info`         | Network statistics, difficulty, and chain work  | None                | `{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"000000000000..."}` |
+| `chain_info`         | Network statistics, difficulty, and chain work  | None                | `{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"0000000000..."}` |
 | `chain_tips`         | Current chain tips including heights and states | None                | `[{"height":826458,"hash":"000000000000...","branchlen":0,"status":"active"}]`        |
 | `circulating_supply` | Current BSV circulating supply                  | None                | `{"bsv":21000000}`                                                                    |
 | `peer_info`          | Connected peer statistics                       | None                | `[{"addr":"1.2.3.4:8333","services":"000000000000...","lastsend":1621234567}]`        |

package/index.ts

@@ -9,6 +9,24 @@ import { registerWalletTools } from "./tools/wallet/tools";
 import { Wallet } from "./tools/wallet/wallet";
 import { registerMneeTools } from "./tools/mnee";
 
+/**
+ * Configuration options from environment variables
+ */
+const CONFIG = {
+	// Whether to load various components
+	loadPrompts: process.env.DISABLE_PROMPTS !== "true",
+	loadResources: process.env.DISABLE_RESOURCES !== "true",
+	loadTools: process.env.DISABLE_TOOLS !== "true",
+	
+	// Fine-grained tool category control
+	loadWalletTools: process.env.DISABLE_WALLET_TOOLS !== "true",
+	loadMneeTools: process.env.DISABLE_MNEE_TOOLS !== "true",
+	loadBsvTools: process.env.DISABLE_BSV_TOOLS !== "true",
+	loadOrdinalsTools: process.env.DISABLE_ORDINALS_TOOLS !== "true",
+	loadUtilsTools: process.env.DISABLE_UTILS_TOOLS !== "true",
+	loadA2bTools: process.env.DISABLE_A2B_TOOLS !== "true",
+};
+
 /**
  * Try to initialize the private key from environment variables
  * Returns the private key if valid, or undefined if not present or invalid
@@ -52,7 +70,7 @@ function initializePrivateKey(): PrivateKey | undefined {
 const privKey = initializePrivateKey();
 
 const server = new McpServer(
-	{ name: "Bitcoin SV", version: "0.0.25" },
+	{ name: "Bitcoin SV", version: "0.0.26" },
 	// {
 	// 	// Advertise only what you actually implement
 	// 	capabilities: {
@@ -71,25 +89,46 @@ const server = new McpServer(
 	// },
 );
 
-// Initialize wallet with the validated private key only if available
+// Initialize wallet and register tools based on configuration
 let wallet: Wallet | null = null;
-if (privKey) {
-  	// Register MNEE tools
-	registerMneeTools(server);
-  // Initialize wallet with the private key
-	wallet = new Wallet(privKey);
-  // Register wallet tools
-  registerWalletTools(server, wallet);
-}
 
-// Register all other tools (BSV, Ordinals, Utils, etc.)
-registerAllTools(server);
+if (CONFIG.loadTools) {
+	if (privKey) {
+		// Register MNEE tools if enabled
+		if (CONFIG.loadMneeTools) {
+			console.log("Registering MNEE tools");
+			registerMneeTools(server);
+		}
+
+		// Initialize wallet with the private key if wallet tools are enabled
+		if (CONFIG.loadWalletTools) {
+			console.log("Initializing wallet and registering wallet tools");
+			wallet = new Wallet(privKey);
+			registerWalletTools(server, wallet);
+		}
+	}
 
-// Register resources
-registerResources(server);
+	// Register all other tools based on configuration
+	console.log("Registering other tools");
+	registerAllTools(server, {
+		enableBsvTools: CONFIG.loadBsvTools,
+		enableOrdinalsTools: CONFIG.loadOrdinalsTools,
+		enableUtilsTools: CONFIG.loadUtilsTools,
+		enableA2bTools: CONFIG.loadA2bTools,
+	});
+}
 
-// Register prompts
-registerAllPrompts(server);
+// Register resources if enabled
+if (CONFIG.loadResources) {
+	console.log("Registering resources");
+	registerResources(server);
+}
+
+// Register prompts if enabled
+if (CONFIG.loadPrompts) {
+	console.log("Registering prompts");
+	registerAllPrompts(server);
+}
 
 // Connect to the transport
 const transport = new StdioServerTransport();

package/package.json

@@ -2,7 +2,7 @@
 	"name": "bsv-mcp",
 	"module": "index.ts",
 	"type": "module",
-	"version": "0.0.25",
+	"version": "0.0.26",
 	"license": "MIT",
 	"author": "satchmo",
 	"description": "A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework",

package/tools/index.ts

@@ -6,25 +6,65 @@ import { registerOrdinalsTools } from "./ordinals";
 import { registerUtilsTools } from "./utils";
 
 /**
- * Register all tools with the MCP server
+ * Configuration options for tools
+ * 
+ * These options can be controlled through environment variables:
+ * - enableBsvTools: controlled by DISABLE_BSV_TOOLS
+ * - enableOrdinalsTools: controlled by DISABLE_ORDINALS_TOOLS
+ * - enableUtilsTools: controlled by DISABLE_UTILS_TOOLS
+ * - enableA2bTools: controlled by DISABLE_A2B_TOOLS
+ */
+export interface ToolsConfig {
+	enableBsvTools?: boolean;
+	enableOrdinalsTools?: boolean;
+	enableUtilsTools?: boolean;
+	enableA2bTools?: boolean;
+}
+
+/**
+ * Register all tools with the MCP server based on configuration
  * @param server The MCP server instance
+ * @param config Configuration options
  */
-export function registerAllTools(server: McpServer): void {
+export function registerAllTools(
+	server: McpServer, 
+	config: ToolsConfig = {
+		enableBsvTools: true,
+		enableOrdinalsTools: true,
+		enableUtilsTools: true,
+		enableA2bTools: true
+	}
+): void {
+	const {
+		enableBsvTools = true,
+		enableOrdinalsTools = true,
+		enableUtilsTools = true,
+		enableA2bTools = true
+	} = config;
+
 	// Register BSV-related tools
-	registerBsvTools(server);
+	if (enableBsvTools) {
+		registerBsvTools(server);
+	}
 
 	// Register Ordinals-related tools
-	registerOrdinalsTools(server);
+	if (enableOrdinalsTools) {
+		registerOrdinalsTools(server);
+	}
 
 	// Register utility tools
-	registerUtilsTools(server);
-
-	// Register agent-to-blockchain discovery tool
-	registerA2bDiscoverTool(server);
+	if (enableUtilsTools) {
+		registerUtilsTools(server);
+	}
 
-	// Register agent-to-agent call tool
-	// registerA2aCallTool(server);
+	// Register agent-to-blockchain tools
+	if (enableA2bTools) {
+		// Register agent-to-blockchain discovery tool
+		registerA2bDiscoverTool(server);
 
+		// Register agent-to-agent call tool
+		// registerA2aCallTool(server);
+	}
 
 	// Add more tool categories as needed
 }