Solana MCP Server
# Solana MCP (Model Context Protocol)



A powerful Model Context Protocol (MCP) server for AI agents to interact with the Solana blockchain and DeFi protocols.
## š Overview
Solana MCP provides a standardized interface for AI agents (like Claude, ChatGPT, etc.) to perform DeFi operations on the Solana blockchain. It bridges the gap between artificial intelligence and decentralized finance, allowing AI systems to:
- Query wallet balances and token holdings
- Transfer SOL and SPL tokens
- Execute token swaps
- Fetch real-time price data
- Perform advanced DeFi operations
Built on top of the [Solana Agent Kit](https://github.com/sendaifun/solana-agent-kit) and the Model Context Protocol (MCP), this tool provides a secure, efficient, and standardized interface for automated DeFi operations.
## š Prerequisites
- Node.js v22.x or later
- npm or yarn package manager
- Solana wallet (keypair)
- RPC endpoint for Solana (e.g., Helius, Alchemy, or your own node)
## š§ Installation
1. Clone this repository:
```bash
git clone https://github.com/caiovicentino/Solana-MCP.git
cd Solana-MCP
```
2. Install dependencies:
```bash
npm install
```
3. Create a `.env` file in the root directory with the following variables:
```
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_rpc_url_here
OPENAI_API_KEY=optional_if_using_openai
```
> ā ļø **Security Warning**: Never commit your `.env` file or expose your private key. Add `.env` to your `.gitignore` file.
4. Build the project:
```bash
npm run build
```
## š Usage
Start the MCP server:
```bash
npm start
```
When successfully started, you should see:
```
ā
Connected to Solana
š Using RPC: [your-rpc-endpoint]
š Wallet configured: [your-wallet-address]
š Starting Yield AI MCP Server...
š Available DeFi actions: 8
āØ Yield AI MCP Server started. Ready to perform DeFi operations on Solana!
```
## š¬ Available Actions
The following DeFi actions are available through the MCP server:
| Action | Description |
|--------|-------------|
| `get_wallet` | Get the current wallet address |
| `check_balance` | Check SOL balance of the wallet |
| `transfer_sol` | Transfer SOL to another wallet |
| `list_tokens` | List all tokens in the wallet |
| `fetch_price` | Fetch current price of a token |
| `trade_tokens` | Execute a trade between tokens |
| `get_tps` | Get current Solana network TPS |
| `swap_tokens` | Swap tokens via liquidity pools |
## š Integration with AI Models
This MCP server is designed to be used with AI models that support the Model Context Protocol. The server uses standard input/output for communication, making it compatible with various AI integration frameworks.
Example of using with Claude:
```typescript
// Example code for integrating with Claude API
// (Placeholder - actual integration depends on your specific AI framework)
```
## š Security Considerations
- Always review transactions before they are executed
- Consider implementing transaction limits
- Secure your private key with proper key management practices
- Use a dedicated wallet with limited funds for testing
- Monitor for any suspicious activities
## š ļø Advanced Configuration
For more advanced configurations, you can modify the following files:
- `src/index.ts`: Main entry point
- `.env`: Environment configuration
## š Resources
- [Solana Documentation](https://docs.solana.com/)
- [Model Context Protocol](https://github.com/anthropics/anthropic-cookbook/tree/main/mcp)
- [Solana Agent Kit](https://github.com/sendaifun/solana-agent-kit)
## š License
This project is licensed under the MIT License - see the LICENSE file for details.
## š¤ Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the project
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request