The DeSo MCP Server transforms Cursor IDE's AI assistant into a comprehensive DeSo development expert, offering tools for:
- Explore DeSo APIs: Access detailed documentation and code examples for all DeSo API categories (social, financial, NFT, identity)
- Generate Production Code: Create ready-to-use code snippets for DeSo operations in JavaScript, TypeScript, React, or cURL
- Guide deso-js SDK Usage: Learn setup, authentication, transactions, and best practices
- Understand DeSo Architecture: Get explanations of systems, transaction flows, and integration patterns
- Search DeSo Repositories: Find documentation and resources across repositories
- Debug Common Issues: Solve integration problems with real solutions
- Implement Best Practices: Learn proven patterns for messaging flows, error handling, and state management
- Access UI Components: Explore 40+ professional React components for building DeSo applications
- Query Blockchain Data: Convert natural language to optimized GraphQL queries
- Develop Complete Apps: Build scalable, production-ready DeSo applications with framework-specific examples
Generates curl commands for interacting with DeSo blockchain APIs, allowing for testing and debugging of DeSo operations directly from the command line.
Provides DeSo GraphQL schema and integration guidance for querying the DeSo blockchain through GraphQL.
Provides comprehensive code generation for DeSo blockchain operations using JavaScript, with detailed guidance on implementing DeSo features.
Provides Next.js-specific implementation patterns for DeSo blockchain integration, including server-side integration and API routes.
Supports Node.js implementation patterns for server-side DeSo blockchain integration with detailed SDK setup guidance.
Offers React component patterns and implementation guidance for DeSo blockchain integration, including authentication flows and state management.
Includes modern UI examples with Tailwind CSS for DeSo applications, demonstrated in the complete messaging application example.
Generates TypeScript code examples for DeSo blockchain integration with type safety, supporting professional-grade DeSo application development.
DeSo MCP Server v3.0 (HTTP)
A comprehensive Model Context Protocol (MCP) server for DeSo blockchain development, now with HTTP transport support.
Features
🛠️ 10 Comprehensive Tools:
deso_api_explorer
- Complete DeSo API documentation and examplesdeso_js_guide
- deso-js SDK setup and usage guidesgenerate_deso_code
- Generate code examples for DeSo operationsexplain_deso_architecture
- Architectural explanations and patternsrepository_search
- Search DeSo repository documentationread_repository_document
- Read specific DeSo docsdeso_debugging_guide
- Real debugging fixes for common issuesdeso_implementation_patterns
- Best practices from production appsdeso_ui_components
- Complete UI component library guidedeso_graphql_helper
- GraphQL query builder and examples
🚀 HTTP Transport:
- RESTful HTTP API instead of stdio
- CORS support for web integration
- Health check endpoint
- Easy deployment and scaling
Quick Start
Local Development
The server will run on http://localhost:3000
by default.
Environment Variables
Docker Deployment
HTTP Endpoints
Health Check
MCP Tool Requests
Send JSON-RPC requests to the root endpoint.
Important:
- MCP requires initialization first, then you can call tools
- Always include the
Accept: application/json, text/event-stream
header - The server runs in stateless mode (no session management required)
Example Usage
JavaScript Client Example
// Debug DeSo Integration Issues const debugInfo = await client.callTool('deso_debugging_guide', { issue: 'message-decryption', includeCode: true });
// Generate GraphQL Queries const query = await client.callTool('deso_graphql_helper', { action: 'build', question: 'How many followers does nader have?', username: 'nader' });
VS Code Integration
Use with MCP-compatible VS Code extensions by configuring the HTTP endpoint:
Architecture
The server uses:
- HTTP Transport: RESTful API with JSON-RPC over HTTP
- CORS Support: Cross-origin requests enabled
- Graceful Shutdown: Proper cleanup on SIGINT/SIGTERM
- Error Handling: Comprehensive error responses
- Health Checks: Built-in monitoring endpoint
Development
Project Structure
Debugging
- Enable debug logging with
DEBUG=mcp:*
- Check server health at
http://localhost:3000/
- Monitor logs for request/response details
License
MIT License - see LICENSE file for details.
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Test with HTTP requests
- Submit a pull request
Support
For issues and questions:
- GitHub Issues: deso-protocol/mcp-server
- DeSo Documentation: docs.deso.org
- Developer Discord: DeSo Developers
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A comprehensive Model Context Protocol server that transforms Cursor's AI assistant into a DeSo blockchain development expert, providing complete API coverage, debugging solutions, and code generation for DeSo applications.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.Last updated -7581Python
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.Last updated -21Python
- -securityFlicense-qualityA Model Context Protocol server that enables Cursor AI assistants to interact with Todoist tasks directly from the coding environment, supporting advanced task filtering and rich formatting.Last updated -37Python
- AsecurityAlicenseAqualityAn enhanced Model Context Protocol server providing comprehensive integration between Trello and Cursor AI with 40+ tools covering multiple Trello API categories for complete project management.Last updated -323452TypeScriptMIT License