Quickstart Guide: Using the MCP Server

This is an example implementation of a Model Context Protocol (MCP) server for the Edwin SDK. It allows AI agents to interact with Edwin's tools through a standardized protocol.

Prerequisites

• Node.js >= 18.0.0

• pnpm (recommended) or npm

• A local Claude instance or access to Claude API

• EVM and/or Solana wallet private keys (depending on your needs)

Installation

1. Clone edwin repository and navigate to the mcp-server directory:

cd examples/mcp-server

1. Install dependencies:

pnpm install

1. Build the project:

pnpm build

Running the Server

Option 1: Local Development

1. Create your environment file:

cp .env.example .env

1. Configure your .env file with the following required settings:

   • SOLANA_RPC_URL: Your RPC endpoint

   • EVM_PRIVATE_KEY: Your EVM wallet private key

   • SOLANA_PRIVATE_KEY: Your Solana wallet private key

   • EDWIN_MCP_MODE=true: Enable MCP mode

2. Start the server:

   • For production: pnpm start

   • For development with hot reloading: pnpm dev

Option 2: Using with Claude Desktop

1. After building the project, use the provided claude_desktop_config.json to configure your Claude Desktop:

   • Open Claude Desktop

   • Go to Settings

   • Import the configuration from claude_desktop_config.json

2. The server will automatically start when needed by Claude Desktop.

Available Tools

The server exposes all tools configured in your Edwin instance. Common tools include:

• Wallet operations

• Balance checking

• Transaction signing

• Token transfers

• Contract interactions

Security Considerations

1. Never commit your .env file with private keys

2. Use appropriate CORS settings in production

3. Implement rate limiting for production use

4. Keep your private keys secure and never share them

Troubleshooting

1. Server won't start:

   • Check if the port is already in use

   • Verify your environment variables are set correctly

   • Check the logs for specific error messages

2. Tools not available:

   • Ensure your Edwin instance is properly configured

   • Check if the tools are properly registered

   • Verify your wallet keys are correct

3. Connection issues:

   • Check if the server is running

   • Verify the port is correct

   • Check network connectivity