MCP Server with Algorand Integration
This server provides blockchain transaction capabilities for the Algorand network along with general utility tools.
Overview
This MCP server provides the following tools to AI assistants:
General Tools
- echo: Echo back any message (useful for testing connectivity)
- calculate: Perform basic mathematical calculations
- get_current_time: Get the current time in any timezone
Algorand Blockchain Tools
- generate_algorand_account: Generate a new Algorand account with address and mnemonic
- get_account_info: Get account information including balance and assets
- send_payment: Send Algo payment transaction
- create_asset: Create a new Algorand Standard Asset (ASA)
- opt_in_to_asset: Opt into an Algorand Standard Asset
- transfer_asset: Transfer an Algorand Standard Asset
- get_asset_info: Get information about an asset
- get_transaction: Get transaction details by transaction ID
Security Features
Mnemonic Phrase Protection
- Encryption: Built-in AES-256-GCM encryption for mnemonic phrases
- Secure Storage: Methods for encrypting/decrypting wallet credentials
- Memory Safety: Sensitive data is handled securely and not logged
Network Configuration
- Testnet Default: Safely defaults to Algorand testnet
- Environment-based: Network configuration through environment variables
- Production Ready: Supports mainnet for production use
Prerequisites
- Node.js 18+
- npm or yarn
- TypeScript
Installation
- Clone or download this project
- Install dependencies:
npm install - Copy environment configuration:
cp .env.example .env - Configure your Algorand network in
.env(defaults to testnet)
Development
Building the Project
npm run build
Running the Server
npm start
Development Mode
For development with automatic rebuilding:
npm run dev
Configuration
For VSCode
{
"mcpServers": {
"algorand-mcp-server": {
"command": "node",
"args": ["path/to/your/project/dist/index.js"]
}
}
}
For VS Code Debugging
The project includes a .vscode/mcp.json configuration file for debugging within VS Code. You can use this with the MCP extension for VS Code.
Available Tools
echo
- Description: Echo back the provided message
- Parameters:
message(string, required): The message to echo back
calculate
- Description: Perform basic mathematical calculations
- Parameters:
expression(string, required): Mathematical expression to evaluate
get_current_time
- Description: Get the current time in a specified timezone
- Parameters:
timezone(string, optional): Timezone identifier (defaults to UTC)
Project Structure
├── src/
│ └── index.ts # Main server implementation
├── dist/ # Compiled JavaScript output
├── .vscode/
│ └── mcp.json # VS Code MCP configuration
├── .github/
│ └── copilot-instructions.md # GitHub Copilot instructions
├── package.json # Node.js package configuration
├── tsconfig.json # TypeScript configuration
└── README.md # This file
Development Guide
Adding New Tools
- Define the tool schema in the
TOOLSarray - Create a Zod schema for input validation
- Add a case in the
CallToolRequestSchemahandler - Implement the tool logic with proper error handling
Example Tool Implementation
const MyToolArgsSchema = z.object({
input: z.string(),
});
// Add to TOOLS array
{
name: 'my_tool',
description: 'Description of what the tool does',
inputSchema: {
type: 'object',
properties: {
input: {
type: 'string',
description: 'Input parameter description',
},
},
required: ['input'],
},
}
// Add to request handler
case 'my_tool': {
const parsed = MyToolArgsSchema.parse(args);
// Implement tool logic here
return {
content: [
{
type: 'text',
text: `Result: ${parsed.input}`,
},
],
};
}
Security Considerations
- Input validation is performed using Zod schemas
- The
calculatetool useseval()for demonstration purposes only - in production, use a safer math evaluation library - Always validate and sanitize inputs before processing
Contributing
- Fork the repository
- Create a feature branch
- Implement your changes with proper tests
- Submit a pull request
License
ISC License - see package.json for details