Stability MCP Ecosystem

A complete Model Context Protocol (MCP) implementation for Stability blockchain, enabling AI agents to interact with Stability Protocol without gas fees.

🏗️ Architecture

stability-mcp/
├─ contracts/          # Solidity smart contracts + Foundry setup
├─ host/               # Node.js orchestrator for MCP hosts
├─ servers/            # MCP server implementations & Docker images
├─ sdk/                # @stbl/mcp - JavaScript/TypeScript SDK
├─ dashboard/          # React SPA for monitoring & management
└─ docs/               # Specifications, ADRs, tutorials

Related MCP server: Flow MCP Server

🎯 What This Provides

MCP Server (servers/)

• Single executable that provides Stability blockchain tools

• Docker images for easy deployment

• Tools provided:

  • post_message - Post messages to blockchain

  • read_contract - Read from smart contracts

  • write_contract - Write to smart contracts

  • deploy_contract - Deploy new contracts

SDK (sdk/)

• @stbl/mcp - TypeScript/JavaScript package

• Easy integration with existing MCP hosts

• Type-safe interfaces for all tools

Host Orchestrator (host/)

• Node.js application that can run MCP servers

• Management interface for multiple MCP instances

• Health checking and monitoring

Smart Contracts (contracts/)

• Foundry project with Stability Protocol contracts

• Test contracts for development

• Deployment scripts

Dashboard (dashboard/)

• React SPA for monitoring MCP servers

• Real-time blockchain interaction logs

• Management interface for API keys and configuration

🚀 Quick Start

1. Install the SDK

npm install @stbl/mcp

2. Run the MCP Server

docker run -e STABILITY_API_KEY=your-key stbl/mcp-server

3. Use with Claude Desktop

{
  "mcpServers": {
    "stability": {
      "command": "docker",
      "args": ["run", "-e", "STABILITY_API_KEY=your-key", "stbl/mcp-server"]
    }
  }
}

📦 Components

🔧 Development

Prerequisites

• Python 3.8+

• Node.js 18+

• Docker

• Foundry (for contracts)

Setup

# Install dependencies
pip install -r servers/requirements.txt
npm install

# Run tests
python -m pytest servers/tests/
npm test
# Build Docker images
docker build -t stbl/mcp-server servers/

# Start Node.js MCP server (experimental)
cd servers/node
npm install
npm run start:mcp
cd ../..

🎯 Why This Architecture?

Simplified MCP Implementation

• Single MCP server instead of complex client/server separation

• Docker-first deployment for easy integration

• SDK for developers who want to integrate directly

Complete Ecosystem

• Not just a server - complete tooling and infrastructure

• Production-ready with monitoring, management, and deployment

• Developer-friendly with good documentation and examples

Real-world Usage

• Works with Claude Desktop out of the box

• Integrates with OpenAI and other MCP hosts

• Scalable for enterprise deployments

🔗 Related Projects

• Stability Protocol

• Model Context Protocol

• Stability Toolkit - Core Python library

📄 License

MIT License - see LICENSE for details.