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

🎯 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.