Solana Vault MCP
A Model Context Protocol (MCP) implementation for secure Solana blockchain wallet operations in python.
Overview
Solana Vault MCP provides secure wallet operations for Solana blockchain through a standardized Model Context Protocol interface. It allows AI assistants to securely interact with the Solana blockchain without direct access to private keys.
Features
- Secure Solana wallet operations
- SOL balance checking
- SOL transfer capabilities
- Transaction history retrieval
- Model Context Protocol compliant API
- Support for Flask web server and WebSocket connections
- Detailed logging and error handling
Installation
Prerequisites
- Python 3.9+
- pip
Setup
-
Clone the repository:
git clone https://github.com/olaxbt/solana-vault-mcp.git cd solana-vault-mcp
-
Create and activate a virtual environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install dependencies:
pip install -r requirements.txt
-
Create a
.envfile based on.env.example:cp .env.example .env
-
Edit the
.envfile to add your Solana private key and RPC URL.
Usage
Starting the Server
python run.py
The server will start on the port specified in your .env file (default: 5000).
API Endpoints
GET /- Welcome page with service informationGET /health- Health check endpointGET /api/mcp/ping- MCP service health checkPOST /api/mcp/query- Main MCP query endpoint
MCP Actions
The Solana Vault MCP supports the following actions:
wallet.info- Get wallet informationwallet.balance- Get SOL balancewallet.transfer- Transfer SOL to another walletwallet.transactions- Get recent transactionswallet.token_balance- Get token balance for a specific token
Example Query
{
"id": "request123",
"action": "wallet.balance",
"params": {}
}
Response:
{
"id": "request123",
"result": {
"balance": 1.5,
"currency": "SOL",
"address": "YourSolanaPublicKey"
}
}
Development
Project Structure
solana-vault-mcp/
├── app/
│ ├── handlers/ # Action handlers
│ ├── routes/ # API routes
│ ├── services/ # Core services
│ └── utils/ # Utilities
├── logs/ # Log files
├── tests/ # Test cases
├── .env # Environment variables
├── .env.example # Example environment file
├── requirements.txt # Dependencies
├── run.py # Main entry point
└── README.md # Documentation
Running Tests
pytest
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Metadata
Release files for iflow-mcp_olaxbt_solana-vault-mcp 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_olaxbt_solana_vault_mcp-1.0.0.tar.gz | 10.0 kB | Without provenance | Details for iflow_mcp_olaxbt_solana_vault_mcp-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_olaxbt_solana_vault_mcp-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_olaxbt_solana_vault_mcp-1.0.0-py3-none-any.whl |
Total release size: 21.3 kB
Release files / iflow_mcp_olaxbt_solana_vault_mcp-1.0.0.tar.gz
| Download URL | iflow_mcp_olaxbt_solana_vault_mcp-1.0.0.tar.gz |
|---|---|
| Size | 10.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
87bea41c3670d3d1cae560a8333250ed2185f9a52e8b7929d5888ea5a1dcbf59
|
|
BLAKE2b-256 checksum How to use checksums |
01c6a52b92ab292b6af9ccfb213bae16675fbbfda85ce1e05877432f53a8e7e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_olaxbt_solana_vault_mcp-1.0.0-py3-none-any.whl
| Download URL | iflow_mcp_olaxbt_solana_vault_mcp-1.0.0-py3-none-any.whl |
|---|---|
| Size | 11.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e479727348c4889c90fa26adffa18c8f7d7bc76f62a05e42af984fb79830aa01
|
|
BLAKE2b-256 checksum How to use checksums |
423d525beadca6238b6d2faeca8450a1e408afa8d8704cb8b81922bbbd5f7204
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_olaxbt_solana-vault-mcp 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.