Skip to main content
Glama

Stability MCP Server

by nuljui
MIT License

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

ComponentPurposeLanguageStatus
servers/MCP Server implementationPython🔧 In Progress
sdk/TypeScript SDKTypeScript📋 Planned
host/Node.js orchestratorNode.js📋 Planned
contracts/Smart contractsSolidity📋 Planned
dashboard/Management UIReact📋 Planned
docs/DocumentationMarkdown📋 Planned

🔧 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

📄 License

MIT License - see LICENSE for details.

Related MCP Servers

  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, providing services like token transfers, contract interactions, and ENS resolution through a unified interface.
    Last updated -
    28
    376
    299
    TypeScript
    MIT License
  • -
    security
    F
    license
    -
    quality
    A Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.
    Last updated -
    1
    JavaScript
    • Linux
    • Apple
  • -
    security
    F
    license
    -
    quality
    A Model Context Protocol server that enables AI agents to interact with the Flow blockchain through RPC calls, supporting account balances, script execution, transactions, domain resolution, and contract interactions.
    Last updated -
    82
    JavaScript
  • -
    security
    F
    license
    -
    quality
    A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
    Last updated -
    16
    1
    TypeScript

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nuljui/stbl-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server