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.