MetaMask Embedded Wallets (Web3Auth) MCP

MetaMask Embedded Wallets MCP 服务

通过让 AI 编码助手实时访问文档并深入了解 SDK，更快地构建 MetaMask Embedded Wallets 集成。

需要设置两项内容：

1. 技能 — 教会 AI 助手如何理解 SDK：架构、框架特性、密钥派生规则和常见错误。技能中不包含代码；由 MCP 提供代码。
2. MCP 服务 — 让 AI 助手实时搜索文档、获取示例并查询 SDK 类型。

---

MCP 工具

工具	功能
search_docs	搜索文档和示例项目
get_doc	获取任意文档页面的完整内容
get_example	获取集成示例的完整源代码
get_sdk_reference	从开源代码库获取 SDK 类型和钩子
search_community	在 MetaMask Builder Hub 中搜索真实用户问题

---

技能

该技能会教 AI 助手理解 MetaMask Embedded Wallets 的思维模型。其中包括 SDK 选择逻辑、密钥派生规则、身份验证概念、平台特性，以及仅靠文档不易发现的常见错误。

提示： 为获得最佳体验，请将 MCP 服务与技能配合使用，这样大模型就能获取实时文档和示例，而不必依赖静态文本。

通用安装（适用于 40 多种 Agent）

npx skills add web3auth/skill

Vercel 的 skills CLI 会检测当前使用的 AI Agent，并自动安装到相应目录 — Cursor、Claude Code、Copilot、Kiro、Cline、Codex、Antigravity，以及另外 40 多种。

若要为特定 Agent 安装：

npx skills add web3auth/skill -a cursor     # Cursor only
npx skills add web3auth/skill -a claude-code # Claude Code only

---

MCP 服务设置

Cursor

最快的方法是一键安装：

也可以通过 Cursor Marketplace 安装 — 搜索 “MetaMask Embedded Wallets”。

或者手动添加。打开 Cursor Settings → Tools & Integrations → MCP 并添加：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

VS Code（GitHub Copilot）

从 Visual Studio Marketplace 安装 — 搜索 “MetaMask Embedded Wallets”，或者：

code --install-extension Web3Auth.metamask-embedded-wallets

也可以使用一键安装 URL：

vscode:mcp/install?{"name":"web3auth","url":"https://mcp.web3auth.io"}

或者手动添加到工作区的 .vscode/mcp.json：

{
  "servers": {
    "web3auth": {
      "type": "http",
      "url": "https://mcp.web3auth.io"
    }
  }
}

JetBrains（IntelliJ、PyCharm、WebStorm、Android Studio）

从 JetBrains Marketplace 安装 — 搜索 “MetaMask Embedded Wallets”。

或者在 Settings → Tools → AI Assistant → Model Context Protocol (MCP) 中手动添加：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io",
      "transport": "http"
    }
  }
}

Claude Code CLI

claude mcp add --transport http web3auth https://mcp.web3auth.io

或者手动添加到项目的 claude.json：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

Claude Desktop

打开 Claude Desktop 配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

将服务添加到 mcpServers 部分：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

重启 Claude Desktop 并询问：“搜索 MetaMask Embedded Wallets 文档中的 React 快速入门”，以验证连接。

ChatGPT Desktop

打开 ChatGPT Desktop → Settings → Connections 并添加新的 MCP 服务：

• 名称：web3auth
• URL：https://mcp.web3auth.io

Windsurf

打开 Windsurf Settings → MCP 并添加：

{
  "mcpServers": {
    "web3auth": {
      "serverUrl": "https://mcp.web3auth.io"
    }
  }
}

或者直接编辑 ~/.codeium/windsurf/mcp_config.json。

Kiro（AWS）

添加到项目的 .kiro/settings/mcp.json：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

Warp Terminal

在 Warp 中，打开 Settings → AI → MCP Servers 并点击 Add Server：

• 名称：web3auth
• URL：https://mcp.web3auth.io

如果当前版本支持，也可以使用 Warp 的 MCP 一键安装功能。

Cline（VS Code）

添加到 Cline MCP 设置中（Ctrl+Shift+P → “Cline: Open MCP Settings”）：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io",
      "transport": "http"
    }
  }
}

Continue.dev

将以下内容添加到 Continue 的 config.json 中（按 Ctrl+Shift+P → “Continue: Open config.json” 打开）：

{
  "mcpServers": [
    {
      "name": "web3auth",
      "url": "https://mcp.web3auth.io"
    }
  ]
}

Zed

将以下内容添加到 Zed 的 settings.json 中（按 Cmd+, 打开）：

{
  "context_servers": {
    "web3auth": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.web3auth.io"]
      }
    }
  }
}

或者通过 Zed Extensions 安装 — 搜索 “MetaMask Embedded Wallets”。

Antigravity

打开你的 MCP 配置文件：

• macOS/Linux：~/.config/antigravity/mcp.json
• Windows：%APPDATA%\antigravity\mcp.json

将服务添加到 mcpServers 部分：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

Antigravity 会热重载 MCP 配置变更 — 无需重启。

Xcode（通过 GitHub Copilot）

Xcode 26.3+ 支持通过 GitHub Copilot 使用 MCP。将服务添加到 Copilot MCP 配置中，或使用上文的 VS Code 扩展设置（Copilot MCP 注册表是共享的）。

或者，通过“设置” → “Copilot” → “MCP Servers”，将 Xcode 的 Agent 工具直接配置为连接 https://mcp.web3auth.io。

Eclipse（通过 GitHub Copilot）

搭配 GitHub Copilot 的 Eclipse 支持 MCP。通过 Eclipse → Preferences → GitHub Copilot → MCP Servers → Add Server 添加：

• 名称：web3auth
• URL：https://mcp.web3auth.io

Neovim（avante.nvim）

在 Lua 配置中，通过 mcphub.nvim 添加：

require("mcphub").setup({
  servers = {
    web3auth = {
      url = "https://mcp.web3auth.io",
      transport = "streamable-http",
    },
  },
})

也可以使用 mcp-remote 以实现兼容：

require("avante").setup({
  mcp = {
    servers = {
      web3auth = {
        command = "npx",
        args = { "-y", "mcp-remote", "https://mcp.web3auth.io" },
      },
    },
  },
})

Neovim（codecompanion.nvim）

require("codecompanion").setup({
  extensions = {
    mcp = {
      servers = {
        web3auth = {
          command = "npx",
          args = { "-y", "mcp-remote", "https://mcp.web3auth.io" },
        },
      },
    },
  },
})

Amp（Sourcegraph）

将以下内容添加到 Amp MCP 配置中：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

Goose

添加到 ~/.config/goose/config.yaml：

extensions:
  - name: web3auth
    type: http
    url: https://mcp.web3auth.io

5ire

在 5ire 设置 → MCP Servers → Add 中添加：

• 名称：web3auth
• URL：https://mcp.web3auth.io

Aider

Aider 通过 LiteLLM 桥接支持 MCP。将以下内容添加到 Aider 配置中：

mcp_servers:
  web3auth:
    command: npx
    args: ["-y", "mcp-remote", "https://mcp.web3auth.io"]

Codex CLI

对于 Codex CLI 或任何仅支持 stdio 的 Agent，请使用 mcp-remote 桥接 HTTP 端点：

npm install -g mcp-remote

然后添加到 ~/.codex/config.toml：

[mcp_servers.web3auth]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.web3auth.io"]

或者添加到 Agent 的 JSON 配置中：

{
  "mcpServers": {
    "web3auth": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.web3auth.io"]
    }
  }
}

---

静态文档（llms.txt）

如果你的 AI 工具尚不支持 MCP，请改用静态文档文件：

https://docs.metamask.io/llms-full.txt

对于支持 llms.txt 规范 且能自动索引文档的工具：

https://docs.metamask.io/llms.txt

警告： 静态文件是一个快照，可能不包含最新更新。如有可能，请使用 MCP 服务以获取始终最新的文档。

---

开始构建

设置好 skill 和 MCP 后，直接向 AI 助手提问。以下是一些不错的入门提示词：

• “在我的 React 应用中添加 MetaMask Embedded Wallets，并使用 Google 登录。”
• “在我的 Next.js 应用中使用 Wagmi 设置社交登录钱包。”
• “在我的 Flutter 应用中集成嵌入式钱包。”
• “为什么我更改登录方式后，用户获得的钱包地址也不同了？”

提示： 初始提示词建议使用规划模式（如支持）。先检查计划，再生成代码 — 这样可以及早发现架构错误，并避免在生产环境中更改钱包地址的配置错误。

---

分发

此仓库为每个主要开发者平台提供构建产物：

平台	类型	位置
Cursor Marketplace	插件	.cursor-plugin/ + mcp.json
VS Code Marketplace	扩展	plugins/vscode/
JetBrains Marketplace	插件	plugins/jetbrains/
Zed Extensions	扩展	plugins/zed/
Claude Agent SDK	插件	plugins/claude/
Raycast Store	扩展	plugins/raycast/
ChatGPT GPT Store	自定义 GPT	openai/
Official MCP Registry	server.json	server.json
Glama	glama.json	glama.json
Smithery	服务卡片	app/.well-known/mcp/server-card.json/route.ts
Vercel skills.sh	Skill	Web3Auth/skill
agentskill.sh	Skill	Web3Auth/skill

---

环境变量

变量	必填	描述
GITHUB_TOKEN	是（托管环境）/ 建议配置（本地）	GitHub 个人访问令牌。在 Vercel 部署（mcp.web3auth.io）中必须配置——get_example 和 get_sdk_reference 会频繁调用 GitHub API；不配置令牌时，共享 IP 很快就会触及每小时 60 次的未认证请求限制。使用本地 stdio 时可选。
DISCOURSE_API_KEY	否	用于 search_community 的 Discourse API 密钥（可选；无需密钥即可进行公开搜索）
DISCOURSE_API_USERNAME	否	使用 DISCOURSE_API_KEY 时所用的 Discourse API 用户名

---

开发

npm install
npm run build
npm test           # Handler smoke tests (mocked fetch)
npm start          # Run via stdio
npm run dev        # Watch mode

更新内容

变更内容	更新位置
SDK 架构、平台差异、密钥派生、工作流	Web3Auth/skill（SKILL.md）
新增示例仓库或扫描根目录（例如新增平台）	src/content/example-catalog.ts
新增 SDK 仓库或发现规则（例如新增平台）	src/content/sdk-catalog.ts
新增工具或参数变更	src/tools/register.ts
现有仓库中的示例文件夹 / SDK 文件布局	无需更新（从 GitHub 实时发现，缓存 4 小时）
文档页面内容	无需更新（通过 Algolia / llms.txt / GitHub 实时获取）

许可证

MIT