Solana AI Terminal

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:

Manual Installation

Usage

Development Mode

Production Mode

Testing

Clean Build

Configuration

Environment Variables

Create a .env file in the root directory:

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

Docker Support

Build and run with Docker:

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:

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

MIT License

Security Considerations

Important Security Notes:

1. Private Keys: Never commit your AGENT_SECRET_KEY to version control

2. Environment Variables: Use secure secret management for production

3. API Access: Limit MCP server access to trusted AI agents

4. Testnet First: Always test on Solana Devnet/Testnet before mainnet operations

Troubleshooting

Build Errors

Connection Issues

• Verify RPC URLs are accessible

• Check network environment (DEVNET vs TESTNET)

• Ensure correct network configuration

Signing Failures

• Verify AGENT_SECRET_KEY is correctly formatted (base58)

• Check private key has required permissions

• Ensure sufficient balance for transaction fees