Solana AI Terminal

<div align="center"> <img src="./docs/images/Solana.jpeg" alt="Solana Logo" width="200"/> </div>

<br/>

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:

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

# 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_KEY is correctly formatted (base58)
• Check private key has required permissions
• Ensure sufficient balance for transaction fees

---

<div align="center"> <p>Made with ❤️ for the Solana ecosystem</p> </div>