base-dev

Base Developer MCP Server provides a comprehensive development assistant for the Base blockchain ecosystem. It exposes a suite of tools to access live documentation, contract addresses, deployment guides, and integration patterns for OnchainKit, Smart Wallets, MiniKit, and related Base infrastructure. You can query tools such as get_base_overview for high-level ecosystem context, get_network_config for mainnet and testnet RPC details, generate_project_template for bootstrapping Base-app templates, and scrape_base_docs or search_base_docs to fetch and filter Base documentation with smart caching. The server’s capabilities are designed to help AI assistants and development tools retrieve accurate Base-specific information, templates, and guides with options to tailor results by framework, feature, or contract type.

Prerequisites:

• Node.js 18+ (recommended)
• npm or yarn

Manual installation steps:

1. Clone the repository and install dependencies:

git clone https://github.com/CodaLabs-xyz/base-dev-mcp-server.git
cd base-dev-mcp-server
npm install

2. Build the server (if a build step is required by the project):

npm run build

3. Start the server locally (if provided as a Node.js service):

npm start

Integration steps for MCP tooling (example for Cursor IDE or Claude Code CLI):

• For Cursor IDE, add the MCP server configuration pointing to your local dist/index.js:

{
  "mcpServers": {
    "base-dev-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/base-dev-mcp-server/dist/index.js"],
      "description": "Base Developer Server - Comprehensive Base ecosystem development assistance"
    }
  }
}

• For Claude Code MCP CLI integration, use a similar path after building the project:

# Local installation (project-specific)
claude mcp add base-dev-mcp-server node /Users/yourname/Projects/base-dev-mcp-server/dist/index.js

Tips:

• Ensure Node.js version matches the project’s requirements (Node.js 18+ is commonly used).
• If the server exposes additional environment variables (e.g., API keys for live docs or RPC providers), set them in your environment before starting the server.
• When updating, re-run npm install and npm run build if required by the project’s build pipeline.
• If you encounter network issues loading external Base docs, consider enabling offline caching or adjusting the caching strategy in the server configuration.
• For production deployments, consider Dockerizing or using PM2 or similar process managers to keep the MCP server running.