区块链MCP服务器工厂

Blockchain MCP Factory Server

Status: frozen (October 2026), alongside BMCPS v3.0. Kept as a reference; no longer actively developed. What works and is tested: validation scoring (factory_validate_server, factory_check_compliance) and MCPB bundling. What does not: servers from factory_scaffold_blockchain are skeletons that need work before they build and run, and factory_create_server depends on shell scripts that are not in this repository.

An MCP server that creates, validates, and manages blockchain MCP servers. Tell Claude (or any MCP client) to spin up a new blockchain server and it does the rest - scaffolding, tool generation, compliance validation, and MCPB bundling.

Built against BMCPS v3.0 (Blockchain MCP Standard).

Quick Start

git clone https://github.com/MyronKoch/blockchain-mcp-factory.git
cd blockchain-mcp-factory
npm install
npm run dev

Add to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "blockchain-factory": {
      "command": "npx",
      "args": ["tsx", "/path/to/blockchain-mcp-factory/src/index.ts"]
    }
  }
}

Test with MCP Inspector

npm run inspect

What It Does

You ask Claude to create a blockchain MCP server. The factory handles:

1. Scaffold from architecture templates (EVM, Cosmos, UTXO, or custom)
2. Generate BMCPS v3.0 compliant tool files with Zod validation and McpError handling
3. Validate servers with 6-dimension scoring (architecture, tools, naming, testing, docs, security)
4. Bundle into .mcpb packages for one-click Claude Desktop installation

The 11 Tools

Architecture Templates

Each template generates example code with SDK imports, client setup, and chain-specific patterns. The output is a starting skeleton, not a server that builds and runs as generated.

Example

You: "Create a Polygon testnet MCP server"

Claude calls: factory_scaffold_blockchain({
  blockchain: "polygon",
  template: "ethereum-like",
  network: "testnet"
})

Result: Server skeleton at servers/testnet/polygon-testnet-mcp-server/
  - 24 BMCPS v3.0 tool definitions
  - EVM client setup with ethers.js
  - Example get_balance and send_transaction code
  - .env.example, README, tsconfig
  - index.ts under 300 lines

Validation Scoring

factory_validate_server scores across 6 dimensions:

Compliance Tiers

Development

npm run dev          # Start with tsx (hot reload)
npm run build        # Compile TypeScript
npm start            # Run compiled
npm run inspect      # MCP Inspector
npm test             # 86 tests (unit + integration + e2e)
npm run test:unit    # Validators only
npm run test:integration  # Full factory tests

Security

• All user inputs validated through dedicated functions (server names, blockchain names, SDK names, tool names, output paths, versions)
• Path traversal prevention via safeResolveServerPath with containment checks
• Shell injection prevention via spawn with shell: false and argument arrays
• No secrets in source, logs use os.tmpdir()
• Three rounds of security audits, all critical/high findings resolved

BMCPS v3.0

This factory generates servers compliant with BMCPS v3.0 (Blockchain MCP Standard v3.0), which defines:

• 24 mandatory tools for single-network servers (25 including set_network for multi-network)
• Modular architecture with category-based tool organization
• {prefix}_{action}_{resource} naming convention
• One tool per file in src/tools/{category}/

License

MIT - Created by Myron Koch