diff --git a/readme.md b/readme.md index fc96619e..d12d43a7 100644 --- a/readme.md +++ b/readme.md @@ -62,40 +62,144 @@ A public API to consume this data is available for free. You can [use it remotel ## MCP Server -Use eth-labels as a tool in Claude Code, Cursor, Windsurf, or any MCP-compatible AI assistant. Ask your AI to identify any crypto address or search for known wallets. +Give your AI the ability to identify any crypto address. Works with Claude, Cursor, Windsurf, VS Code, and any MCP-compatible client. + +**170k+ labeled addresses and tokens across EVM chains. No clone. No build. Just install.** + +> **Requires:** Node.js 18+ ### Setup +Pick your AI client and follow the instructions. Every option uses the [eth-labels-mcp](https://www.npmjs.com/package/eth-labels-mcp) npm package — no need to clone this repo. + +
+Claude Code + ```sh -# Clone and build -git clone https://github.com/dawsbot/eth-labels.git -cd eth-labels/mcp -npm install -npm run build +claude mcp add eth-labels-mcp -- npx eth-labels-mcp ``` -### Add to Claude Code +Done. -Add to your `~/.claude/claude_desktop_config.json`: +
+ +
+Claude Desktop + +Edit your config file: + +| OS | Path | +|----|------| +| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` | +| Windows | `%APPDATA%\Claude\claude_desktop_config.json` | +| Linux | `~/.config/Claude/claude_desktop_config.json` | ```json { "mcpServers": { "eth-labels": { - "command": "node", - "args": ["/path/to/eth-labels/mcp/dist/index.js"] + "command": "npx", + "args": ["eth-labels-mcp"] } } } ``` +Restart Claude Desktop after saving. + +
+ +
+Cursor + +Add to `.cursor/mcp.json` in your project root (or open **Settings → Features → MCP Servers → Add**): + +```json +{ + "mcpServers": { + "eth-labels": { + "command": "npx", + "args": ["-y", "eth-labels-mcp"] + } + } +} +``` + +
+ +
+Windsurf + +Add to `~/.codeium/windsurf/mcp_config.json`: + +```json +{ + "mcpServers": { + "eth-labels": { + "command": "npx", + "args": ["-y", "eth-labels-mcp"] + } + } +} +``` + +
+ +
+VS Code (GitHub Copilot) + +Add to `.vscode/settings.json` in your project: + +```json +{ + "mcp": { + "servers": { + "eth-labels": { + "command": "npx", + "args": ["-y", "eth-labels-mcp"] + } + } + } +} +``` + +
+ +
+Cline + +Open **Cline → MCP Servers → Configure**, then add: + +```json +{ + "mcpServers": { + "eth-labels": { + "command": "npx", + "args": ["-y", "eth-labels-mcp"] + } + } +} +``` + +
+ +### Verify it works + +Once configured, ask your AI: + +``` +Search for "uniswap" addresses +``` + +If it returns labeled Uniswap addresses — you're in. 🎉 + ### Tools | Tool | Description | | ---------------- | ---------------------------------------------------------------------------------- | | `lookup_address` | Look up any Ethereum/EVM address to get its label and name tag | | `search_labels` | Search by project name, label, or token symbol (e.g. "uniswap", "binance", "USDC") | -| `dataset_stats` | Get dataset statistics — 68k+ accounts, 27k+ tokens, 95k+ total entries | +| `dataset_stats` | Get dataset statistics — 115k+ accounts, 54k+ tokens, 170k+ total entries | ### Example