SparkMango

Sparkmango lets agents generate and use MCP servers from contract ABIs

python

3

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "arjunbhuptani-sparkmango": {
      "command": "mcp-server",
      "args": [
        "start",
        "--port",
        "8000"
      ]
    }
  }
}

SparkMango is an MCP server that converts Solidity bytecode into a functional Python-based server implementation, enabling you to expose contract logic as a RESTful API and manage contract state with ease.

How to use

You will generate a Python MCP server from your Solidity contract, run the server, and then interact with it through a client to perform actions, query state, and listen for events. The server automatically translates contract structures into server endpoints, handles state, and provides a testing framework for validation.

How to install

Prerequisites: you need Python and pip installed on your system.

pip install mcp-server

Generate a server from your Solidity contract (ensure you have a contract.json available at the specified path). The command outputs the server project to your chosen directory.

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

Start the generated MCP server on a port of your choice (8000 is used as an example). You can adjust the port as needed.

mcp-server start --port 8000

Additional sections

Notes and practical guidance: SparkMango provides automatic server generation from Solidity contracts, RESTful API endpoints for contract interaction, and state management for contract variables. Use the generated server to implement contract logic in Python, expose endpoints for client applications, and run tests against your contract-driven APIs.

Security and testing: leverage the built-in testing framework to validate behavior, and apply standard security practices for API endpoints and contract access. Review any environment-specific settings in the generated output to ensure you meet your deployment requirements.

Available tools

contract_to_server

Converts Solidity contracts into Python server implementations by generating a functional MCP server skeleton from the contract JSON.

generate_server

Creates a complete server project from a Solidity contract, including REST endpoints and state handling.

start_server

Launches the generated MCP server, exposing the REST API on the specified port.

state_management

Maintains contract variables and state transitions within the generated server to reflect contract behavior.

rest_endpoints

Provides RESTful API endpoints for interacting with contract functions, events, and queries.

event_handling

Supports subscription or handling of contract events to notify clients of changes.

testing_framework

Includes a testing framework to validate server behavior against contract logic.