🛡️ BICScan MCP Server: Empowering LLMs with Blockchain Risk Intelligence

Harness the power of the BICScan API to provide your Language Model applications with comprehensive blockchain risk assessments and asset information, seamlessly integrated through the Model Context Protocol (MCP).

🚀 Key Capabilities

• Advanced Risk Scoring: Evaluate the risk associated with crypto addresses, domain names, and decentralized applications (dApps) using a sophisticated scoring system (0-100, where 100 signifies high risk).
• Detailed Asset Insights: Uncover comprehensive asset holdings for specified crypto addresses across multiple blockchain networks, including cryptocurrencies and tokens.
• Real-Time Threat Intelligence: Leverage the BICScan API for real-time scanning, delivering up-to-the-minute insights into potential risks and asset portfolios.
• Robust and Secure Architecture: Built with meticulous error handling and comprehensive logging to ensure dependable and secure operation.
• MCP Compliant: Seamlessly integrates with LLM applications via the Model Context Protocol, enabling contextual awareness for enhanced decision-making.

⚙️ Installation and Configuration

Choose your preferred deployment method: uv, Docker, or uvx.

1. Method 1: Running with uv

1.1. Prerequisites

• Python 3.10+
• uv (version 0.6.x)
• git

1.2. Clone the Repository

git clone https://github.com/ahnlabio/bicscan-mcp

1.3. Configure claude_desktop_config.json

Append the following configuration to your claude_desktop_config.json file.

Important: Replace the placeholders:

• YOUR_BICSCAN_REPO_DIR_HERE: The absolute path to your cloned bicscan-mcp repository (e.g., C:\\Users\\ABC\\repo\\bicscan-mcp or /home/abc/repo/bicscan-mcp).
• YOUR_BICSCAN_API_KEY_HERE: Your BICScan API key (obtained from https://bicscan.io - see instructions below).

{
  "mcpServers": {
    // ... other MCP servers ...
    "bicscan": {
      "command": "uv",
      "args": [
        "--directory",
        "YOUR_BICSCAN_REPO_DIR_HERE",
        "run",
        "bicscan-mcp"
      ],
      "env": {
        "BICSCAN_API_KEY": "YOUR_BICSCAN_API_KEY_HERE"
      }
    }
  }
}

2. Method 2: Running with Docker

2.1. Prerequisites

• Docker environment

2.2. Clone the Repository

git clone https://github.com/ahnlabio/bicscan-mcp

2.3. Build the Docker Image

Execute make within the repository directory to build the Docker image.

2.4. Configure claude_desktop_config.json

Append the following configuration to your claude_desktop_config.json file.

Important: Replace YOUR_BICSCAN_API_KEY_HERE with your BICScan API key (obtained from https://bicscan.io - see instructions below).

{
  "mcpServers": {
    // ... other MCP servers ...
    "bicscan": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--env", "BICSCAN_API_KEY=YOUR_BICSCAN_API_KEY_HERE",
        "bicscan-mcp"
      ]
    }
  }
}

3. Method 3: Running with uvx

3.1. Prerequisites

• Python 3.10+
• uv (version 0.6.x)
• git

3.2. Configure claude_desktop_config.json

Append the following configuration to your claude_desktop_config.json file.

Important: Replace YOUR_BICSCAN_API_KEY_HERE with your BICScan API key (obtained from https://bicscan.io - see instructions below).

{
  "mcpServers": {
    // ... other MCP servers ...
    "bicscan": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ahnlabio/bicscan-mcp",
        "bicscan-mcp"
      ],
      "env": {
        "BICSCAN_API_KEY": "YOUR_BICSCAN_API_KEY_HERE"
      }
    }
  }
}

🔑 Obtaining Your Free BICScan API Key

1. Visit https://bicscan.io and register for an account.
2. Navigate to your profile and select "Create App."
3. Provide a name and description for your application.
4. Copy the generated API key.
5. Replace the YOUR_BICSCAN_API_KEY_HERE placeholder in your claude_desktop_config.json with your newly obtained API key.
6. Restart your Claude Desktop application.

Now your LLM applications can leverage the power of BICScan for enhanced blockchain risk assessment and asset intelligence!