Base Dev MCP Server

基本开发人员MCP服务器

一个全面的模型上下文协议（MCP）服务器，提供广泛的基础区块链开发工具、文档和资源。该服务器使AI助手和开发工具能够访问有关Base生态系统、智能合约、部署指南、OnchainKit集成、智能钱包、MiniKit等的详细信息。

🌟 增强功能

📚 实时文档和搜索

• 实时文档抓取 来自docs.base.org，带有智能缓存
• 智能搜索功能 跨基础文档并进行相关性评分
• 特定部分过滤 深度内容提取
• 缓存结果 以提高性能并减少API调用

🔗 完整的基础链集成

• 合同地址 用于核心协议、DeFi、NFT（主网和测试网）
• 多个RPC端点 具有WebSocket支持和归档节点
• 网络配置 实时天然气价格和区块信息
• 资源管理器链接 以及交易监控工具

🧰 高级开发工具

• 智能合约生成器 使用基础优化模板（ERC20、ERC721、Multisig、DAO）
• 部署指南 适用于Hardhat、Foundry、Remix、Thirdweb，并附有验证
• 气体优化策略 以及基地特定的最佳实践
• 项目模板 以及样板代码生成

🎨 OnchainKit深度集成

• 组件示例 具有生产就绪的代码片段
• 钱包、身份、交易、掉期、框架 组件指南
• 安装说明 以及依赖关系管理
• API文档 以及使用模式

🌐 综合生态系统图

• DeFi协议 使用TVL数据、合同地址和集成指南
• NFT市场 Base上的热门系列
• 游戏和社交平台 建在基地
• 基础设施工具 包括预言机、索引器和RPC提供程序

🌉 桥梁和跨链解决方案

• 官方基地大桥 详细信息和使用模式
• 第三方桥梁 比较（LayerZero、Stargate、Hop、Across）
• 传输时间分析、费用结构和安全模型
• 气体优化 跨链运营策略

🛠️ 可用工具（共17个）

知识库覆盖率

核心文件

• Base OnchainKit -React组件、实用程序、API参考和类型
• 基本帐户 -智能钱包的实施和集成
• 基础应用程序 -迷你应用程序开发和部署
• 基础链 -网络信息、工具和基础设施
• 基础食谱 -实用的实施方案
• 快速入门指南 -开始使用所有基础产品

涵盖的关键主题

• 用户入职和钱包集成
• 加密货币支付受理和处理
• AI代理开发和部署
• 代币发行和分发
• 专用基础设施的应用链部署
• 具有用户身份的社交应用程序开发
• DeFi集成收益和交易功能
• 具有账户抽象的无气体交易
• 跨链互操作性和桥接
• 节点操作和基础设施管理

🚀 Claude Code快速入门

先决条件

• Node.js 18+
• 克劳德代码CLI
• npm或纱线

易于安装（推荐）

1. 克隆和构建：

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

1. 使用Claude Code MCP CLI进行安装：

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

# Or global installation (system-wide)
claude mcp add base-dev-mcp-server -s user node $(pwd)/dist/index.js

1. 验证安装：

claude mcp list

1. 开始使用：

现在，您可以向Claude Code提出以下问题：

• *“演示如何集成OnchainKit Swap组件”*
• *“生成针对Base优化的ERC20合同”*
• *“获取基本主网RPC端点和天然气价格”*
• *“Base上有哪些DeFi协议？”*

安装和设置

先决条件

• Node.js 18+
• npm或纱线

手动开发设置

1. 克隆和安装依赖关系：

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

1. 构建服务器：

npm run build

1. 测试服务器：

npm start

与AI编码助手集成

添加到游标IDE

1. 克隆并构建服务器：

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

1. 打开光标设置：

- 按 Cmd/Ctrl + , 打开设置 - 导航到“扩展”→ “模型上下文协议” - 或在设置中搜索“MCP”

1. 添加MCP服务器配置：

将以下内容添加到光标MCP设置中（替换 /absolute/path/to/ 根据您的实际路径）：

{
  "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"
    }
  }
}

1. 实际路径示例：

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

添加到Claude代码（CLI）-易于安装

1. 克隆并构建服务器：

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

1. 使用Claude Code MCP CLI安装（推荐）：

本地安装（项目特定）：

   claude mcp add base-dev-mcp-server node /Users/yourname/Projects/base-dev-mcp-server/dist/index.js

全局安装（全系统可用）：

   claude mcp add base-dev-mcp-server -s user node /Users/yourname/Projects/base-dev-mcp-server/dist/index.js

注： 替换 /Users/yourname/Projects/ 使用克隆存储库的实际路径。

1. 验证安装：

   claude mcp list

1. 替代方案：手动配置（高级）：

如果您更喜欢手动设置，请在以下位置创建或编辑您的Claude Code配置文件 ~/.config/claude-code/config.json:

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

1. 使用特定于项目的设置：

添加到您的项目 package.json:

{
  "scripts": {
    "mcp:base-dev": "node /absolute/path/to/base-dev-mcp-server/dist/index.js"
  }
}

然后配置Claude Code以使用：

{
  "mcpServers": {
    "base-dev-mcp-server": {
      "command": "npm",
      "args": ["run", "mcp:base-dev"],
      "cwd": "/path/to/your/project"
    }
  }
}

添加到其他MCP兼容工具

1. 首先克隆并构建服务器：

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

1. 对于任何兼容MCP的AI编码助手：

{
  "servers": {
    "base-dev-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/base-dev-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

使用示例

集成后，您可以向AI助手提出以下问题：

OnchainKit开发

• “如何将OnchainKit集成到我的React应用程序中？”
• “显示OnchainKit交换组件的使用情况”
• “OnchainKit实用程序有哪些可用功能？”
• “生成OnchainKit交易组件示例”

智能钱包和账户抽象

• “如何在Next.js应用程序中实现智能钱包？”
• “演示如何设置无气体交易”
• “在Base上进行帐户抽象有什么好处？”
• “如何为赞助交易配置出纳员？”

AI代理开发

• “我如何构建一个在Base上交易的AI代理？”
• “演示如何创建自主DeFi代理”
• “Base AI代理有哪些可用的框架？”
• “我如何在Base上部署AI代理？”

DeFi集成

• “如何将令牌交换添加到我的应用程序中？”
• “演示如何实现产量农业功能”
• “Base上有哪些DeFi协议？”
• “我如何整合借贷？”

代币和项目启动

• “如何在Base上启动令牌？”
• “代币部署的最佳平台是什么？”
• “演示如何创建模因币”
• “我如何设置代币流动性？”

基础设施和节点运营

• “如何运行Base节点？”
• “基本节点的硬件要求是什么？”
• “显示基本网络配置”
• “如何解决节点同步问题？”

跨链和桥接

• “我如何将代币桥接到Base？”
• “哪些跨链解决方案适用于Base？”
• “演示如何实现跨链功能”
• “如何将LayerZero与Base集成？”

社交和迷你应用程序

• “如何在Base上构建社交应用程序？”
• “显示MiniKit集成示例”
• “什么是基本迷你应用程序？”
• “如何创建Farcaster Frame？”

配置选项

环境变量

• NODE_ENV -环境（开发/生产）
• LOG_LEVEL -日志记录级别（调试/信息/警告/错误）

服务器配置

MCP服务器可以通过修改配置 src/index.ts:

• 通过扩展工具处理程序添加新工具
• 修改响应格式
• 添加自定义文档源
• 扩大知识库覆盖范围

故障排除

常见问题

1. 服务器无法启动：

- 确保已安装Node.js 18+ - 检查是否安装了依赖项： npm install - 验证构建是否完成： npm run build

1. MCP连接问题：

- 验证到的绝对路径 dist/index.js 是正确的 - 检查服务器是否独立运行： node dist/index.js - 确保MCP配置中的JSON格式正确

1. 工具响应为空：

- 检查服务器日志是否有错误 - 验证工具参数是否与预期模式匹配 - 通过简单的请求测试单个工具

调试模式

使用调试日志运行服务器：

LOG_LEVEL=debug node dist/index.js

知识库文件

服务器包括来自以下方面的全面文档：

• src/knowledge/base-onchainkit.json -OnchainKit组件、API、实用程序、类型
• src/knowledge/base-account.json -智能钱包和账户抽象
• src/knowledge/base-app.json -迷你应用程序和基础应用程序开发
• src/knowledge/base-chain.json -网络信息、工具、基础设施
• src/knowledge/base-cookbook.json -实施方案和指南
• src/knowledge/quickstart-guides.json -入门指南

贡献

1. 分叉存储库
2. 创建要素分支
3. 添加新工具或改进现有工具
4. 更新文档
5. 提交拉取请求

添加新工具

1. 在中定义工具模式 src/index.ts
2. 将工具添加到 ListToolsRequestSchema 处理器
3. 在中实现工具处理程序 CallToolRequestSchema 处理器
4. 添加全面的文档和示例

更新知识库

1. 将新的JSON文件添加到 src/knowledge/
2. 更新工具处理程序以包含新知识
3. 使用相关查询进行测试
4. 用新功能更新README

许可证

MIT许可证-版权所有（c）2025 Base Developer MCP服务器

请参阅 许可证 文件以获取详细信息。

支持

• 基础文档
• OnChainKit文档
• MCP规范
• 问题

______________________________________________________________________

为基地生态系统而建 🔵 由MCP供电 🤖

*最后更新日期：2025年7月27日*