Model Context Protocol (MCP) server that enables AI agents like Claude to interact with the Solana blockchain network.
Features
- Official Solana documentation search
- Blockchain queries (accounts, transactions, blocks)
- Wallet management and creation
- Cryptographic signing operations
- Support for Devnet and Testnet
Quick Start
Prerequisites
- Node.js 18+
- pnpm 10.14.0+
Installation
Installing via Smithery
To install Solana Dev Essentials automatically via Smithery:
npx -y @smithery/cli install @fozagtx/solanaaiterminal
Manual Installation
# Install dependencies
pnpm install
# Build the project
pnpm build
Usage
Development Mode
# Run in development mode
pnpm dev
Production Mode
# Build the project
pnpm build
# Start the server
pnpm start
Testing
pnpm test
Clean Build
# Remove build artifacts
pnpm clean
Configuration
Environment Variables
Create a .env file in the root directory:
# Network Configuration
ENVIRONMENT=DEVNET # DEVNET or TESTNET
# Wallet Configuration (required for signing)
AGENT_SECRET_KEY=your_base58_private_key_here
# Server Configuration
USE_STREAMABLE_HTTP=false # true for HTTP mode
PORT=3000 # HTTP server port
HOST=127.0.0.1 # HTTP server host
See .env.example for a template.
Network Information
Devnet
- Network: Devnet
- RPC URL: https://api.devnet.solana.com
- Explorer: https://explorer.solana.com/?cluster=devnet
- Native Token: SOL (Devnet)
- Faucet: https://faucet.solana.com/
Testnet
- Network: Testnet
- RPC URL: https://api.testnet.solana.com
- Explorer: https://explorer.solana.com/?cluster=testnet
- Native Token: SOL (Testnet)
- Faucet: https://faucet.solana.com/
Project Structure
solana/
├── src/ # Server source code
├── dist/ # Built output
├── .env # Environment variables (gitignored)
├── .env.example # Environment template
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
├── Dockerfile # Docker configuration
├── .dockerignore # Docker ignore patterns
├── smithery.yaml # Smithery configuration
├── somnia-mcp-stdio.example.json # STDIO mode config
├── somnia-mcp-streamable-http.json # HTTP mode config
└── README.md # This file
Docker Support
Build and run with Docker:
# Build Docker image
docker build -t solana-mcp-server .
# Run container
docker run -p 3000:3000 --env-file .env solana-mcp-server
Deployment
MCP Server
For deployment instructions to Smithery or other platforms, see DEPLOYMENT.md.
Important: Ensure AGENT_SECRET_KEY is set as an environment variable in your deployment platform, not hardcoded in the Dockerfile.
Documentation Site
The docs/ folder contains a static HTML documentation site. For hosting instructions, see docs/HOSTING.md.
Quick Deploy:
- GitHub Pages (recommended)
- Vercel:
vercel --prod - Netlify: Drag & drop at https://app.netlify.com/drop
- Surge:
cd docs && surge
Resources
- Solana Documentation
- Solana Explorer (Devnet)
- Solana Explorer (Testnet)
- Solana Discord
- Solana Twitter
- Model Context Protocol
Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
MIT License
Security Considerations
Important Security Notes:
- Private Keys: Never commit your
AGENT_SECRET_KEYto version control - Environment Variables: Use secure secret management for production
- API Access: Limit MCP server access to trusted AI agents
- Testnet First: Always test on Solana Devnet/Testnet before mainnet operations
Troubleshooting
Build Errors
# Clear all dependencies and rebuild
pnpm clean
rm -rf node_modules pnpm-lock.yaml
pnpm install
pnpm build
Connection Issues
- Verify RPC URLs are accessible
- Check network environment (DEVNET vs TESTNET)
- Ensure correct network configuration
Signing Failures
- Verify
AGENT_SECRET_KEYis correctly formatted (base58) - Check private key has required permissions
- Ensure sufficient balance for transaction fees
Made with ❤️ for the Solana ecosystem