{"_id":"@bnb-chain/mcp-server","_rev":"4-2276f68c67ae3b558bede87e0e3d1208","name":"@bnb-chain/mcp-server","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@bnb-chain/mcp-server","version":"0.0.1","license":"MIT","_id":"@bnb-chain/mcp-server@0.0.1","maintainers":[{"name":"robot-ux","email":"robot.ux@protonmail.com"}],"bin":{"bnbchain-mcp-server":"dist/cli/index.js"},"dist":{"shasum":"e7d03a51c91e92772299eba145e636750f22aed7","tarball":"https://registry.npmjs.org/@bnb-chain/mcp-server/-/mcp-server-0.0.1.tgz","fileCount":10,"integrity":"sha512-9F1ZKlRA/FP1cpYe5nOG7Xp2v9Rij8eDNA2dPQm7JdfoVtJIKDVoD/MjnsKdPbu2GJatLBlsVOns6L82VHqQQA==","signatures":[{"sig":"MEUCIAZm5sqv6yYYLpyXgKSf662sC3HE69J+QjgNsppxPfDUAiEA1DTQv4ornKHcX3SSrf0DY/J6QNGv9TnATcoaZHy3UwE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5055237},"module":"index.ts","gitHead":"345393ce567ad5d0d1415fe4afc640e1ac855127","scripts":{"dev":"bun --watch run src/server/stdio.ts","test":"npx @modelcontextprotocol/inspector bun dev","build":"bun build src/**/*.ts --outdir dist --target node","start":"node dist/server/stdio.js","format":"prettier --write .","dev:sse":"bun --watch run src/server/sse.ts","prepare":"husky","start:sse":"node dist/server/sse.js"},"_npmUser":{"name":"robot-ux","email":"robot.ux@protonmail.com"},"commitlint":{"rules":{"subject-case":[2,"always",["sentence-case"]]},"extends":["@commitlint/config-conventional"]},"_npmVersion":"10.2.4","description":"A MCP server for BNB Chain that supports BSC, opBNB, Greenfield, and other popular EVM-compatible networks.","directories":{},"_nodeVersion":"20.11.1","dependencies":{"zod":"^3.22.4","cors":"^2.8.5","viem":"^2.27.2","dotenv":"^16.5.0","express":"^4.18.2","typescript":"^5.0.0","@modelcontextprotocol/sdk":"^1.9.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.6","prettier":"3.2.4","@types/cors":"^2.8.17","@types/node":"^20.0.0","@types/express":"^4.17.21","@commitlint/cli":"^19.5.0","@commitlint/config-conventional":"^19.5.0","@ianvs/prettier-plugin-sort-imports":"4.1.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.0.1_1745227644460_0.1463717478812092","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-04-21T09:27:24.383Z","modified":"2026-01-07T06:47:15.271Z","0.0.1":"2025-04-21T09:27:24.701Z"},"license":"MIT","description":"A MCP server for BNB Chain that supports BSC, opBNB, Greenfield, and other popular EVM-compatible networks.","maintainers":[{"email":"robot.ux@protonmail.com","name":"robotnpm"},{"email":"devin@nodereal.io","name":"devinxiang"},{"email":"aiden.c@nodereal.io","name":"aiden-cao"},{"email":"yolin@bnbchain.org","name":"robotbnb"}],"readme":"# BNBChain MCP (Model Context Protocol)\n\nA powerful toolkit for interacting with BNB Chain and other EVM-compatible networks through natural language processing and AI assistance.\n\n## Description\n\nBNBChain MCP is a Model Context Protocol implementation that enables seamless interaction with blockchain networks through AI-powered interfaces. It provides a comprehensive set of tools and resources for blockchain development, smart contract interaction, and network management.\n\n## Core Modules\n\nThe project is organized into several core modules:\n\n- **Blocks**: Query and manage blockchain blocks\n- **Contracts**: Interact with smart contracts\n- **Network**: Network information and management\n- **NFT**: NFT (ERC721/ERC1155) operations\n- **Tokens**: Token (ERC20) operations\n- **Transactions**: Transaction management\n- **Wallet**: Wallet operations and management\n- **Common**: Shared utilities and types\n\n## How to Use in Cursor\n\nTo connect to the MCP server from Cursor:\n\n1. Open Cursor and go to Settings (gear icon in the top right)\n2. Click on \"MCP\" in the left sidebar\n3. Click \"Add new global MCP server\"\n4. Enter the following details:\n\nDefault mode\n\n```json\n{\n  \"mcpServers\": {\n    \"bnbchain-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bnb-chain/mcp-server\"]\n    }\n  }\n}\n```\n\nSSE mode\n\n```json\n{\n  \"mcpServers\": {\n    \"bnbchain-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bnb-chain/mcp-server\", \"--sse\"]\n    }\n  }\n}\n```\n\n## Development\n\n### Prerequisites\n\n- [bun](http://bun.sh/) 1.2.10 or higher\n\n```bash\n# Install dependencies\nbun install\n\n# Start the development server\nbun dev\n```\n\n## Supported Tools and Resources\n\n| Name                                                               | Description                                           |\n| ------------------------------------------------------------------ | ----------------------------------------------------- |\n| [`get_chain_info`](src/evm/modules/network/tools.ts)               | Get information about an EVM network                  |\n| [`get_supported_networks`](src/evm/modules/network/tools.ts)       | Get a list of supported EVM networks                  |\n| [`get_transaction`](src/evm/modules/transactions/tools.ts)         | Get detailed information about a specific transaction |\n| [`get_transaction_receipt`](src/evm/modules/transactions/tools.ts) | Get a transaction receipt by its hash                 |\n| [`estimate_gas`](src/evm/modules/transactions/tools.ts)            | Estimate the gas cost for a transaction               |\n| [`transfer_eth`](src/evm/modules/wallet/tools.ts)                  | Transfer native tokens (ETH, BNB, etc.) to an address |\n| [`transfer_token`](src/evm/modules/tokens/tools.ts)                | Transfer ERC20 tokens to another address              |\n| [`approve_token_spending`](src/evm/modules/tokens/tools.ts)        | Approve another address to spend your ERC20 tokens    |\n| [`transfer_nft`](src/evm/modules/nft/tools.ts)                     | Transfer an NFT (ERC721 token) to another address     |\n| [`transfer_erc1155`](src/evm/modules/nft/tools.ts)                 | Transfer ERC1155 tokens to another address            |\n| [`check_nft_ownership`](src/evm/modules/nft/tools.ts)              | Check if an address owns a specific NFT               |\n| [`get_nft_info`](src/evm/modules/nft/tools.ts)                     | Get detailed information about a specific NFT         |\n| [`get_address_from_private_key`](src/evm/modules/wallet/tools.ts)  | Get the EVM address derived from a private key        |\n| [`resolve_ens`](src/evm/modules/network/tools.ts)                  | Resolve an ENS name to an EVM address                 |\n| [`is_contract`](src/evm/modules/contracts/tools.ts)                | Check if an address is a smart contract or EOA        |\n\n## Supported Networks\n\nSupports BSC, opBNB, Ethereum, and other major EVM-compatible networks. For more details, see [`src/evm/chains.ts`](src/evm/chains.ts).\n\n## Testing\n\nWe use the @modelcontextprotocol/inspector tool for testing. Run the following command to open a UI interface for inspection:\n\n```bash\nbun run test\n```\n\n## Contributing\n\nWe welcome contributions to BNBChain MCP! Here's how you can help:\n\n1. Fork the repository\n2. Create a feature branch\n3. Commit your changes\n4. Push to your branch\n5. Create a Pull Request\n\nPlease ensure your code follows our coding standards and includes appropriate tests.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","readmeFilename":"README.md"}