Blockchain-Research-MCP

agentis-dev/Blockchain-Research-MCP

3.2

If you are the rightful owner of Blockchain-Research-MCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A comprehensive blockchain research MCP server with real-time data integration from various APIs.

Tools

  1. create-research-plan

    Creates a structured research plan for blockchain projects.

  2. fetch-blockchain-data

    Fetches real-time blockchain data from various sources.

  3. analyze-defi-protocol

    Analyzes DeFi protocols with comprehensive metrics.

  4. track-whale-activity

    Tracks large wallet movements and whale transactions.

  5. research-nft-collection

    Comprehensive NFT collection analysis.

Blockchain Research MCP

šŸ” Comprehensive blockchain research MCP server with dynamic data sources

A powerful Model Context Protocol (MCP) server that provides comprehensive blockchain research capabilities with real-time data integration from CoinGecko, DeFiLlama, and other APIs.

šŸš€ Features

šŸ”¬ Research Management

  • Structured Research Plans: Create comprehensive research templates for tokens, DeFi protocols, NFTs, and DAOs
  • Progress Tracking: Monitor research progress with task dependencies and status updates
  • Dynamic Templates: Customizable research workflows based on project type

šŸ“Š Real-Time Data Integration

  • Price & Market Data: Live data from CoinGecko API
  • DeFi Analytics: TVL, yield farming, and protocol metrics from DeFiLlama
  • On-Chain Analysis: Transaction patterns, holder distribution, and supply metrics
  • NFT Research: Floor prices, volume, rarity analysis, and market trends
  • Governance Monitoring: DAO proposals, voting patterns, and participation rates

šŸ‹ Advanced Analytics

  • Whale Tracking: Monitor large wallet movements and transactions
  • Risk Assessment: Comprehensive security and market risk analysis
  • Competitive Analysis: Compare projects and protocols
  • Trend Analysis: Historical data and pattern recognition

šŸŒ Web Content Integration

  • Smart Web Scraping: Extract content from blockchain-related websites
  • Multiple Formats: Support for text, HTML, markdown, and JSON output
  • Content Classification: Automatic categorization of articles, data tables, and links
  • Rate Limiting: Respectful scraping with domain-specific rate limits

šŸ’¾ Resource Management

  • Persistent Storage: Local caching of research data and web content
  • Resource Collections: Organize related content into collections
  • Search & Filter: Quick access to stored research and data
  • Export/Import: Share research data and backup capabilities

šŸ“‹ Requirements

  • Node.js v16 or higher
  • npm or yarn package manager

šŸ› ļø Installation

Quick Install via npm

npm install -g blockchain-research-mcp

Development Setup

  1. Clone the repository
git clone <repository-url>
cd blockchain-research-mcp
  1. Install dependencies
npm install
  1. Build the project
npm run build
  1. Start the server
npm start

šŸ”Œ Integration

Claude Desktop

Edit your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the server configuration:

{
  "mcpServers": {
    "blockchain-research-mcp": {
      "command": "npx",
      "args": ["-y", "blockchain-research-mcp@latest"]
    }
  }
}

Cursor IDE

Add to your Cursor MCP configuration (~/.cursor/mcp.json):

{
  "mcpServers": {
    "blockchain-research-mcp": {
      "command": "npx",
      "args": ["-y", "blockchain-research-mcp@latest"]
    }
  }
}

šŸ§° Available Tools

šŸ“‹ create-research-plan

Creates a structured research plan for blockchain projects.

Parameters:

  • projectName (string): Name of the blockchain project
  • projectType (enum): token | protocol | defi | nft | dao | layer1 | layer2
  • researchScope (array): Areas to cover (technical, financial, social, governance, security, market)

šŸ“ˆ fetch-blockchain-data

Fetches real-time blockchain data from various sources.

Parameters:

  • dataType (enum): price | market-cap | volume | tvl | transactions | holders | supply
  • identifier (string): Token symbol, contract address, or project identifier
  • blockchain (enum): ethereum | bitcoin | polygon | bsc | avalanche | solana | arbitrum
  • timeframe (enum): 1h | 24h | 7d | 30d | 90d | 1y

šŸ¦ analyze-defi-protocol

Analyzes DeFi protocols with comprehensive metrics.

Parameters:

  • protocolName (string): Name of the DeFi protocol
  • analysisType (enum): overview | tvl-analysis | yield-farming | risk-assessment | governance

šŸ‹ track-whale-activity

Tracks large wallet movements and whale transactions.

Parameters:

  • tokenAddress (string): Token contract address
  • blockchain (enum): ethereum | polygon | bsc | avalanche | arbitrum
  • minAmount (number): Minimum transaction amount in USD
  • timeRange (enum): 1h | 6h | 24h | 7d

šŸ–¼ļø research-nft-collection

Comprehensive NFT collection analysis.

Parameters:

  • collectionName (string): Name of the NFT collection
  • contractAddress (string): NFT contract address (optional)
  • analysisDepth (enum): basic | detailed | comprehensive

šŸ—³ļø monitor-governance

Monitors DAO governance and proposal activity.

Parameters:

  • daoName (string): Name of the DAO
  • proposalStatus (enum): active | pending | executed | defeated | all

šŸŒ fetch-web-content

Fetches and processes blockchain-related web content.

Parameters:

  • url (string): URL to fetch content from
  • format (enum): text | html | markdown | json
  • extractType (enum): article | data-table | links | images | all

šŸ“Š update-research-status

Updates research section status and progress.

Parameters:

  • researchId (string): Research project identifier
  • section (string): Research section name
  • status (enum): planned | in-progress | completed | blocked
  • notes (string): Optional status notes

šŸ“ Available Prompts

šŸ” blockchain-project-research

Comprehensive blockchain project research template with structured analysis framework.

šŸ¦ defi-protocol-analysis

DeFi protocol deep dive analysis covering TVL, yields, risks, and tokenomics.

šŸ–¼ļø nft-collection-report

NFT collection research template with market metrics and rarity analysis.

šŸ—³ļø governance-analysis

DAO governance and proposal analysis framework.

šŸ’” Usage Examples

Research a Token

// Create research plan
await createResearchPlan({
  projectName: "Ethereum",
  projectType: "token",
  researchScope: ["technical", "financial", "market"]
});

// Fetch current data
await fetchBlockchainData({
  dataType: "price",
  identifier: "ethereum",
  timeframe: "24h"
});

Analyze DeFi Protocol

// Comprehensive protocol analysis
await analyzeDefiProtocol({
  protocolName: "Uniswap",
  analysisType: "overview"
});

// Track TVL trends
await fetchBlockchainData({
  dataType: "tvl",
  identifier: "uniswap",
  timeframe: "30d"
});

Monitor Whale Activity

// Track large ETH movements
await trackWhaleActivity({
  tokenAddress: "0x...", // USDC contract
  blockchain: "ethereum",
  minAmount: 1000000, // $1M+
  timeRange: "24h"
});

Research NFT Collection

// Comprehensive NFT analysis
await researchNftCollection({
  collectionName: "Bored Ape Yacht Club",
  analysisDepth: "comprehensive"
});

šŸ”§ Configuration

Environment Variables

Create a .env file in the project root:

# API Keys (optional - increases rate limits)
COINGECKO_API_KEY=your_api_key_here
ETHERSCAN_API_KEY=your_api_key_here

# Cache Settings
CACHE_DIRECTORY=./research_cache
MAX_CACHE_AGE_DAYS=30

# Rate Limiting
REQUESTS_PER_MINUTE=30
ENABLE_RATE_LIMITING=true

Custom Data Sources

The MCP server supports adding custom data sources by extending the BlockchainDataProvider class:

class CustomDataProvider extends BlockchainDataProvider {
  async fetchCustomData(params: any) {
    // Your custom implementation
  }
}

šŸ“ Project Structure

blockchain-research-mcp/
ā”œā”€ā”€ src/
ā”‚   ā”œā”€ā”€ index.ts                 # Main entry point
ā”‚   ā”œā”€ā”€ server.ts                # MCP server implementation
ā”‚   ā”œā”€ā”€ providers/
ā”‚   ā”‚   ā””ā”€ā”€ blockchain-data-provider.ts  # Data fetching logic
ā”‚   ā”œā”€ā”€ research/
ā”‚   ā”‚   ā””ā”€ā”€ research-manager.ts          # Research workflow management
ā”‚   ā”œā”€ā”€ utils/
ā”‚   ā”‚   ā””ā”€ā”€ content-fetcher.ts          # Web scraping utilities
ā”‚   ā””ā”€ā”€ resources/
ā”‚       ā””ā”€ā”€ resource-manager.ts         # Data storage management
ā”œā”€ā”€ build/                       # Compiled JavaScript
ā”œā”€ā”€ research_cache/              # Local data cache
ā”œā”€ā”€ package.json
ā”œā”€ā”€ tsconfig.json
ā””ā”€ā”€ README.md

šŸ¤ Contributing

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

šŸ“Š Data Sources

This MCP integrates with various blockchain data providers:

āš ļø Rate Limits & Best Practices

  • CoinGecko: 30 calls/minute (free tier)
  • DeFiLlama: No strict limits, but be respectful
  • Web Scraping: 1 request/second per domain
  • Caching: Data is cached locally to reduce API calls
  • Error Handling: Graceful fallbacks for API failures

šŸ“„ License

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

šŸ”— Links

Built with ā¤ļø for the blockchain research community