Sparkmango

🚀 SparkMango

A Model Context Protocol (MCP) server that converts Solidity bytecode into a functional server implementation, bridging the gap between Solidity smart contracts and Python-based server applications.

🚀 Quick Start

SparkMango serves as a bridge between Solidity smart contracts and Python-based server applications. It can automatically generate Python implementations from Solidity contracts, enabling easier interaction with blockchain contracts via REST-based APIs.

✨ Features

• Convert Solidity contracts into Python implementations.
• Automatically generate servers.
• Manage contract variable states.
• Provide REST-based API endpoints.
• Handle events.
• Offer a comprehensive testing framework.

📦 Installation

pip install mcp-server

💻 Usage Examples

Basic Usage

1. Generate a server from a Solidity contract:

mcp-server generate --contract path/to/contract.json --output output_directory

2. Start the server:

mcp-server start --port 8000

📚 Documentation

For detailed documentation, please refer to the docs directory.

🔧 Technical Details

Environment Setup

1. Clone the repository:

git clone https://github.com/ArjunBhuptani/sparkmango.git
cd sparkmango

2. Install dependencies:

pip install -r requirements.txt
pip install -r requirements-test.txt

Testing

Run the test suite:

python -m pytest

📄 License

This project is released under the MIT License. For details, please see the LICENSE file.

Contribution Guidelines

Contributions are welcome! Please feel free to submit a Pull Request.

Project Status

For the current project status and upcoming features, please check PROJECT_STATUS.md.