Starknet MCP

🚀 Starknet MCP Server

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

🚀 Quick Start

Features

• 📝 Retrieve the latest block from Starknet.

To-Do List

• [ ] Add tools for interacting with Starknet smart contracts.

Prerequisites

• Node.js 18+

Installation

Install via Smithery

To automatically install the Starknet MCP Server for Claude Desktop 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

2. Install dependencies:

npm install

3. Create an .env file:

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

# Log level (debug, info, warn, error)
LOG_LEVEL=debug
# 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

Start the Server

# Development mode with hot reload
npm run dev

# Production mode
npm start

Available Tools

get_block

Retrieve the latest block from the Starknet blockchain.

Example input:

{
  "blockNumber": 1234567890
}

🔧 Technical Details

Project Structure

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

Run Tests

npm test

🤝 Contribution

1. Fork the repository.
2. Create a 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 LICENSE file for details.

🔗 Resources

• Starknet Documentation
• Starknetjs Documentation
• Model Context Protocol
• Visual Testing Tool for MCP Servers
• Awesome MCP Servers
• Awesome MCP Clients
• MCP TypeScript SDK

📬 Contact

If you have any questions or suggestions, feel free to contact me. You can find me via:

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

Or directly scan this QR code to find me: