README Documentation
SparkMango
A Model Context Protocol (MCP) server that converts Solidity bytecode into a functional server implementation.
Overview
SparkMango provides a bridge between Solidity smart contracts and Python-based server applications. It automatically generates server implementations from Solidity contracts, making it easier to interact with blockchain contracts through a RESTful API.
Features
- Convert Solidity contracts to Python implementations
- Automatic server generation
- State management for contract variables
- RESTful API endpoints
- Event handling
- Comprehensive testing framework
Installation
pip install mcp-server
Usage
- Generate a server from a Solidity contract:
mcp-server generate --contract path/to/contract.json --output output_directory
- Start the server:
mcp-server start --port 8000
Development
Setup
- Clone the repository:
git clone https://github.com/ArjunBhuptani/sparkmango.git
cd sparkmango
- Install dependencies:
pip install -r requirements.txt
pip install -r requirements-test.txt
Testing
Run the test suite:
python -m pytest
Documentation
For detailed documentation, please refer to the docs directory.
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.
Project Status
For current project status and upcoming features, see PROJECT_STATUS.md.
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source