starknet-mcp

starknet-mcp

5
cloud_platformsdeveloper_tools

Starknet MCP Server is designed to allow AI models to interact seamlessly with the Starknet blockchain using the Model Context Protocol. It offers features such as retrieving the latest block data and provides a development environment based on Node.js.

🌐 Starknet MCP Server

A Model Context Protocol (MCP) server that enables AI models to interact with Starknet.

smithery badge TypeScript MCP Starknet

🚀 Features

  • 📝 Get the latest block from Starknet

👷‍♂️ TODOs

  • Add tools to be able to interact with smart contracts on Starknet

📋 Prerequisites

  • Node.js 18+

🛠️ Installation

Installing via Smithery

To install Starknet MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @AbdelStark/starknet-mcp --client claude

Manual Installation

  1. Clone the repository:
git clone https://github.com/AbdelStark/starknet-mcp
cd starknet-mcp
  1. Install dependencies:
npm install
  1. Create a .env file:

💡 You can copy the .env.example file and modify it as needed.

# Log level (debug, info, warn, error)
LOG_LEVEL=debug
# Node environment (development, production)
NODE_ENV=development
# Server mode (stdio or sse)
SERVER_MODE=sse
# Port for SSE mode
PORT=9000
# Starknet RPC URL
STAKNET_RPC_URL=https://...

🚦 Usage

Starting the Server

# Development mode with hot reload
npm run dev

# Production mode
npm start

Available Tools

get_block

Gets the latest block from the Starknet blockchain.

Example input:

{
  "blockNumber": 1234567890
}

🔧 Development

Project Structure

starknet-mcp/
├── src/
│   ├── index.ts        # Main server entry point
│   ├── types.ts        # TypeScript type definitions
├── .env               # Environment configuration
└── tsconfig.json     # TypeScript configuration

Running Tests

npm test

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the file for details.

🔗 Resources

📬 Contact

Feel free to follow me if you'd like, using my public key:

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

Or just scan this QR code to find me:

Starknet Public Key QR Code