@mcp-dockmaster/mcp-cryptowallet-evm 1.0.0 → 1.0.2

package/.env.example

@@ -0,0 +1,2 @@
+# Optional private key for wallet operations
+PRIVATE_KEY=your_private_key_here

package/README.md

@@ -91,6 +91,12 @@ This will download and execute the server directly from npm.
 
 ## Configuration
 
+### Environment Variables
+
+The MCP server supports the following environment variables:
+
+- `PRIVATE_KEY`: Optional private key to use for wallet operations when no wallet is explicitly provided
+
 ### Configure Claude Desktop
 
 To configure Claude Desktop to use this MCP server:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-dockmaster/mcp-cryptowallet-evm",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server for EVM crypto wallet operations using ethers.js v5",
   "main": "build/index.js",
   "type": "module",

package/src/handlers/utils.ts

@@ -64,12 +64,23 @@ export const getProvider = (providerUrl?: string): ethers.providers.Provider =>
  * @returns An ethers.js wallet
  */
 export const getWallet = async (
-  walletData: string, 
+  walletData?: string, 
   password?: string,
   providerUrl?: string
 ): Promise<ethers.Wallet> => {
   const provider = providerUrl ? getProvider(providerUrl) : undefined;
   
+  // If walletData is not provided, check for PRIVATE_KEY environment variable
+  if (!walletData && process.env.PRIVATE_KEY) {
+    const wallet = new ethers.Wallet(process.env.PRIVATE_KEY);
+    return provider ? wallet.connect(provider) : wallet;
+  }
+  
+  // If no walletData and no environment variable, throw an error
+  if (!walletData) {
+    throw new Error("Wallet data is required or set PRIVATE_KEY environment variable");
+  }
+  
   try {
     // Try to parse as JSON first
     if (walletData.startsWith("{")) {

package/src/handlers/wallet.ts

@@ -170,10 +170,6 @@ export const encryptWalletHandler = async (input: any): Promise<ToolResultSchema
 
 export const getAddressHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     const wallet = await getWallet(input.wallet);
 
     return createSuccessResponse({
@@ -186,10 +182,6 @@ export const getAddressHandler = async (input: any): Promise<ToolResultSchema<an
 
 export const getPublicKeyHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     const wallet = await getWallet(input.wallet);
 
     return createSuccessResponse({
@@ -202,10 +194,6 @@ export const getPublicKeyHandler = async (input: any): Promise<ToolResultSchema<
 
 export const getPrivateKeyHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     const wallet = await getWallet(input.wallet, input.password);
 
     return createSuccessResponse({
@@ -219,9 +207,6 @@ export const getPrivateKeyHandler = async (input: any): Promise<ToolResultSchema
 
 export const getBalanceHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
     if (!input.provider) {
       return createErrorResponse("Provider URL is required to get balance");
     }
@@ -244,10 +229,6 @@ export const getBalanceHandler = async (input: any): Promise<ToolResultSchema<an
 
 export const getChainIdHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     const wallet = await getWallet(input.wallet, input.password, input.provider);
 
     if (!wallet.provider) {
@@ -268,10 +249,6 @@ export const getChainIdHandler = async (input: any): Promise<ToolResultSchema<an
 
 export const getGasPriceHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     const wallet = await getWallet(input.wallet, input.password, input.provider);
 
     if (!wallet.provider) {
@@ -294,10 +271,6 @@ export const getGasPriceHandler = async (input: any): Promise<ToolResultSchema<a
 
 export const getTransactionCountHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     const wallet = await getWallet(input.wallet, input.password, input.provider);
 
     if (!wallet.provider) {
@@ -318,10 +291,6 @@ export const getTransactionCountHandler = async (input: any): Promise<ToolResult
 
 export const callHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     if (!input.transaction) {
       return createErrorResponse("Transaction is required");
     }
@@ -348,10 +317,6 @@ export const callHandler = async (input: any): Promise<ToolResultSchema<any>> =>
 
 export const sendTransactionHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     if (!input.transaction) {
       return createErrorResponse("Transaction is required");
     }
@@ -389,10 +354,6 @@ export const sendTransactionHandler = async (input: any): Promise<ToolResultSche
 
 export const signTransactionHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     if (!input.transaction) {
       return createErrorResponse("Transaction is required");
     }
@@ -415,10 +376,6 @@ export const signTransactionHandler = async (input: any): Promise<ToolResultSche
 
 export const populateTransactionHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     if (!input.transaction) {
       return createErrorResponse("Transaction is required");
     }
@@ -461,10 +418,6 @@ export const populateTransactionHandler = async (input: any): Promise<ToolResult
 
 export const signMessageHandler = async (input: any): Promise<ToolResultSchema<any>> => {
   try {
-    if (!input.wallet) {
-      return createErrorResponse("Wallet is required");
-    }
-
     if (!input.message) {
       return createErrorResponse("Message is required");
     }

package/src/tools.ts

@@ -135,9 +135,9 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" }
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }
       },
-      required: ["wallet"]
+      required: []
     }
   },
   {
@@ -146,9 +146,9 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" }
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." }
       },
-      required: ["wallet"]
+      required: []
     }
   },
   {
@@ -157,10 +157,10 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         password: { type: "string", description: "The password to decrypt the wallet if it's encrypted" }
       },
-      required: ["wallet"]
+      required: []
     }
   },
   // Blockchain Methods
@@ -170,11 +170,11 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         provider: { type: "string", description: "Optional JSON RPC provider URL" },
         blockTag: { type: "string", description: "Optional block tag (latest, pending, etc.)" }
       },
-      required: ["wallet", "provider"]
+      required: ["provider"]
     }
   },
   {
@@ -183,10 +183,10 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         provider: { type: "string", description: "Optional JSON RPC provider URL" }
       },
-      required: ["wallet"]
+      required: []
     }
   },
   {
@@ -195,10 +195,10 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         provider: { type: "string", description: "Optional JSON RPC provider URL" }
       },
-      required: ["wallet"]
+      required: []
     }
   },
   {
@@ -207,11 +207,11 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         provider: { type: "string", description: "Optional JSON RPC provider URL" },
         blockTag: { type: "string", description: "Optional block tag (latest, pending, etc.)" }
       },
-      required: ["wallet"]
+      required: []
     }
   },
   {
@@ -220,7 +220,7 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         provider: { type: "string", description: "Optional JSON RPC provider URL" },
         transaction: { 
           type: "object", 
@@ -237,7 +237,7 @@ export const tools = [
         },
         blockTag: { type: "string", description: "Optional block tag (latest, pending, etc.)" }
       },
-      required: ["wallet", "transaction"]
+      required: ["transaction"]
     }
   },
 
@@ -248,7 +248,7 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         provider: { type: "string", description: "Optional JSON RPC provider URL" },
         transaction: { 
           type: "object", 
@@ -268,7 +268,7 @@ export const tools = [
           required: ["to"]
         }
       },
-      required: ["wallet", "transaction"]
+      required: ["transaction"]
     }
   },
   {
@@ -277,7 +277,7 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         provider: { type: "string", description: "Optional JSON RPC provider URL" },
         transaction: { 
           type: "object", 
@@ -297,7 +297,7 @@ export const tools = [
           required: ["to"]
         }
       },
-      required: ["wallet", "transaction"]
+      required: ["transaction"]
     }
   },
   {
@@ -306,7 +306,7 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         provider: { type: "string", description: "Optional JSON RPC provider URL" },
         transaction: { 
           type: "object", 
@@ -326,7 +326,7 @@ export const tools = [
           required: ["to"]
         }
       },
-      required: ["wallet", "transaction"]
+      required: ["transaction"]
     }
   },
 
@@ -337,10 +337,10 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         message: { type: "string", description: "The message to sign" }
       },
-      required: ["wallet", "message"]
+      required: ["message"]
     }
   },
   {
@@ -349,12 +349,12 @@ export const tools = [
     inputSchema: {
       type: "object",
       properties: {
-        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON)" },
+        wallet: { type: "string", description: "The wallet (private key, mnemonic, or JSON). If not provided, uses PRIVATE_KEY environment variable if set." },
         domain: { type: "object", description: "The domain data" },
         types: { type: "object", description: "The type definitions" },
         value: { type: "object", description: "The value to sign" }
       },
-      required: ["wallet", "domain", "types", "value"]
+      required: ["domain", "types", "value"]
     }
   },
   {