Skip to content

README.md

Latest commit

 

History

History
166 lines (122 loc) · 3.51 KB

README.md

File metadata and controls

166 lines (122 loc) · 3.51 KB

GoPlus MCP Configuration Guide

This guide explains how to set up GoPlus MCP Server for use with GoPlus Security Skills.

Overview

GoPlus MCP (Model Context Protocol) Server enables Claude to access GoPlus Security's blockchain analysis capabilities directly.

Prerequisites

  1. Node.js v18 or higher
  2. GoPlus API Credentials from gopluslabs.io/security-api

Installation

Option 1: NPM Global Install (Recommended)

npm install -g goplus-mcp

Option 2: Local Development

git clone https://github.com/GoPlusSecurity/goplus-mcp.git
cd goplus-mcp
npm install
npm run build

Configuration

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "goplus": {
      "command": "goplus-mcp",
      "args": [],
      "env": {
        "GOPLUS_API_KEY": "your-api-key-here",
        "GOPLUS_API_SECRET": "your-api-secret-here"
      }
    }
  }
}

Claude Desktop (Windows)

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "goplus": {
      "command": "goplus-mcp",
      "args": [],
      "env": {
        "GOPLUS_API_KEY": "your-api-key-here",
        "GOPLUS_API_SECRET": "your-api-secret-here"
      }
    }
  }
}

Claude Code (Project-level)

Create .mcp.json in your project root:

{
  "mcpServers": {
    "goplus": {
      "command": "goplus-mcp",
      "env": {
        "GOPLUS_API_KEY": "${GOPLUS_API_KEY}",
        "GOPLUS_API_SECRET": "${GOPLUS_API_SECRET}"
      }
    }
  }
}

Then set environment variables:

export GOPLUS_API_KEY="your-api-key"
export GOPLUS_API_SECRET="your-api-secret"

Using Local Development Build

If using local build instead of npm global:

{
  "mcpServers": {
    "goplus": {
      "command": "node",
      "args": ["/path/to/goplus-mcp/dist/index.js"],
      "env": {
        "GOPLUS_API_KEY": "your-api-key",
        "GOPLUS_API_SECRET": "your-api-secret"
      }
    }
  }
}

Verification

After configuration, restart Claude and test with:

Analyze token security on Ethereum: 0xdAC17F958D2ee523a2206206994597C13D831ec7

Expected: Detailed USDT security analysis including honeypot status, taxes, and contract security.

Troubleshooting

"MCP server not found"

  1. Verify goplus-mcp is installed: which goplus-mcp
  2. Check Node.js version: node --version (should be ≥18)
  3. Restart Claude after config changes

"API authentication failed"

  1. Verify API credentials at GoPlus Dashboard
  2. Check for typos in config file
  3. Ensure no extra whitespace in keys

"Tool not available"

  1. Check MCP server is running in Claude's developer tools
  2. Verify config JSON syntax is valid
  3. Try reinstalling: npm install -g goplus-mcp@latest

Security Best Practices

  1. Never commit API keys - Use environment variables
  2. Rotate keys regularly - Update credentials periodically
  3. Monitor usage - Check GoPlus dashboard for unusual activity

API Rate Limits

GoPlus API has rate limits based on your plan:

Plan Requests/Day Requests/Second
Free 1,000 5
Pro 100,000 50
Enterprise Unlimited Custom

Skills handle rate limiting gracefully with retry logic.

Next Steps