What is Demcp Debank Mcp

demcp-debank-mcp is a stateless Model Context Protocol (MCP) server designed to interact with the DeBanK API, enabling users to retrieve blockchain and DeFi data efficiently.

Use cases

Use cases for demcp-debank-mcp include querying blockchain information, retrieving user asset details, analyzing DeFi protocols, and managing wallet functionalities.

How to use

To use demcp-debank-mcp, clone the repository and ensure you have Deno 1.35 or later installed. Obtain a DeBanK API Access Key and follow the provided instructions to set up and run the server.

Key features

Key features include a stateless architecture for scalability, comprehensive tools for accessing DeFi data, pagination support for list endpoints, and robust error handling.

Where to use

demcp-debank-mcp can be used in various fields including blockchain analytics, DeFi applications, and any service requiring real-time access to decentralized finance data.

DeBanK MCP Server

A stateless Model Context Protocol (MCP) server for interacting with the DeBanK API to retrieve blockchain and DeFi data.

Overview

This project implements a Model Context Protocol (MCP) server that provides various tools for querying blockchain data, including chains, protocols, tokens, pools, and user assets. Built with the @modelcontextprotocol/sdk, it leverages the HTTP Streamable transport to provide a modern, efficient API interface.

The server is designed to be completely stateless, with each request being handled independently, making it highly scalable and robust for production environments.

Features

• Stateless Architecture: Each request creates a new server instance and transport
• Comprehensive DeFi Data Tools: Access to chains, protocols, tokens, pools, and user data
• Pagination Support: All list-returning endpoints support pagination
• Error Handling: Robust error handling and reporting

Tools Available

Prerequisites

• Deno 1.35 or later
• DeBanK API Access Key - Get one here

Installation

1. Clone the repository

git clone https://github.com/yourusername/debank-mcp-server.git
cd debank-mcp-server

2. Set up your environment variables

export ACCESS_KEY=your_debank_api_key

Running the Server

Start the server with the following command:

deno run --allow-net --allow-env main.ts

The server will start and listen on port 8080 by default. You can now send MCP requests to http://localhost:8080/mcp.

MCP HTTP Streamable Implementation

This project uses the StreamableHTTPServerTransport from the Model Context Protocol SDK to handle MCP requests. Every request creates a new server instance and transport, making the service completely stateless:

// Create new server instance and transport for each request
const server = createServer();
const transport = new StreamableHTTPServerTransport({
  sessionIdGenerator: () => randomUUID(),
});

// Connect to server
await server.connect(transport);

// Handle request
await transport.handleRequest(req, res, req.body);

This approach simplifies deployment and scaling, as there’s no need to manage session state across multiple instances.

Project Structure

├── main.ts                # Main server file with MCP endpoint handling
├── deno.json              # Deno configuration
├── deno.lock              # Dependency lock file
├── tool/
│   ├── toolInfo.ts        # Tool definitions
│   └── toolHandler.ts     # Tool handler implementations
└── README.md              # This file

Configuration

The following environment variables can be configured:

• ACCESS_KEY - Your DeBanK API access key
• PORT - (Optional) Port to run the server on (default: 8080)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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

Acknowledgments

• Model Context Protocol
• DeBanK API