Privy MCP Server

Privy.io MCP 服务器

一个模型上下文协议（MCP）服务器用于 Privy.io（可译为“普瑞维.io”或根据具体语境简化为“普瑞维”等，但通常直接保留原名以体现品牌特色） - Web3钱包基础设施平台。通过Claude及其他MCP客户端，提供全面的用户管理、钱包操作以及区块链交互访问。

特点/特性

用户管理

• 获取用户详细信息通过Privy去中心化身份（DID）检索用户信息，包括关联账户、多因素认证（MFA）方法和元数据
• 列出用户所有用户的分页列表（默认每页50条）
• 搜索用户通过搜索词和可选标识符（电子邮件、电话号码、钱包地址）搜索用户
• 按钱包查询通过区块链钱包地址查找用户
• 创建用户创建具有关联账户的新用户（电子邮件、电话、钱包、OAuth 提供商）
• 删除用户删除用户及其相关数据

钱包管理

• 获取钱包获取钱包详情，包括地址、链类型和时间戳
• 列出钱包带元数据的分页钱包列表
• 创建钱包为用户生成钱包（以太坊、Solana、比特币、兼容EVM的链）
• 钱包余额检查当前钱包余额
• 交易历史分页获取钱包交易历史
• 更新钱包修改钱包元数据和配置

安装

先决条件

• Python 3.10或更高版本
• 带有API凭证的Privy.io帐户

快速入门uvx（推荐）

使用这个MCP服务器最简单的方法是通过 uvx，它会自动从 PyPI 获取该包：

uvx privy-mcp-server

无需安装！配置您的MCP客户端（参见 使用方法/用途 （如下所示），然后你就可以出发了。

手动安装（开发）

对于本地开发：

1. 克隆仓库：

git clone https://github.com/incentivai-io/privy-mcp-server.git
cd privy-mcp-server

1. 创建虚拟环境:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

1. 安装依赖项：

pip install -e .

1. 配置环境变量：

cp .env.example .env

编辑 .env 并添加您的Privy凭据：

PRIVY_APP_ID=your_app_id_here
PRIVY_APP_SECRET=your_app_secret_here

获取你的凭证仪表盘 → 应用设置 → 基本信息 Privy.io（注：这是一个公司或平台的名称，直接翻译可能无法准确传达其含义，因此保持原样）

使用方法

运行服务器

直接使用Python运行：

python -m privy_mcp

或者使用MCP检查器进行测试：

npx @modelcontextprotocol/inspector python -m privy_mcp

例如，从项目目录中：

npx @modelcontextprotocol/inspector python -m privy_mcp

使用Claude Desktop进行配置

在您的Claude桌面配置文件中添加：

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

使用uvx（推荐）

{
  "mcpServers": {
    "privy": {
      "command": "uvx",
      "args": ["privy-mcp-server"],
      "env": {
        "PRIVY_APP_ID": "your_app_id_here",
        "PRIVY_APP_SECRET": "your_app_secret_here"
      }
    }
  }
}

使用本地安装的Python

{
  "mcpServers": {
    "privy": {
      "command": "python",
      "args": ["-m", "privy_mcp"],
      "env": {
        "PRIVY_APP_ID": "your_app_id_here",
        "PRIVY_APP_SECRET": "your_app_secret_here"
      }
    }
  }
}

配置完成后重启Claude桌面版。

可用工具

用户管理

• get_user - 通过Privy去中心化身份（DID）获取用户详细信息。返回的数据包括关联账户（电子邮件、电话、钱包、OAuth提供商）、多因素认证（MFA）方法、创建时间戳、条款接受情况以及自定义元数据
• list_users - 列出所有用户，并支持分页。返回带有分页功能的用户列表，包括他们的关联账户、钱包和元数据（每页默认50条）
• search_users - 通过搜索词和可选标识符（电子邮件、电话号码、钱包地址）搜索用户。返回符合搜索条件的用户数据，包括关联账户、多因素认证（MFA）方法和元数据
• get_user_by_wallet - 通过区块链钱包地址查询和检索用户信息。支持以太坊、Solana、比特币以及所有兼容EVM（以太坊虚拟机）的链
• create_user - 创建一个具有关联账户的新用户。支持电子邮件、电话、钱包以及15+个OAuth提供商（如Apple、Discord、GitHub、Google、Farcaster、Telegram、Twitter等）。可选地创建一个嵌入式钱包
• delete_user - 通过Privy DID删除用户。此操作是永久性的，并将删除所有相关数据

钱包管理

• get_wallet - 通过钱包ID获取钱包详情。返回钱包地址、链类型、创建/导出/导入的时间戳、策略ID以及所有者信息
• list_wallets - 列出所有钱包，并支持分页。返回钱包地址、链类型以及相关元数据
• create_wallet - 为用户创建或预先生成一个钱包。支持以太坊、Solana、比特币以及所有与EVM（以太坊虚拟机）兼容的链
• get_wallet_balance - 获取钱包的当前余额
• get_wallet_transactions - 获取支持分页的指定钱包的交易历史
• update_wallet - 更新钱包元数据和配置

示例查询

一旦在Claude Desktop中进行配置，您就可以询问：

• “列出我Privy应用程序中的所有用户”
• “获取DID did:privy:xxx 的用户详细信息”
• “搜索邮箱为user@example.com的用户”
• “通过钱包地址0x123...查找用户”
• “搜索匹配‘john’且电话号码为+1234567890的用户”
• “创建一个新用户，邮箱为 user@example.com”
• “为用户 did:privy:xxx 在 Solana 上创建一个钱包”
• “显示系统中所有的钱包”
• “获取钱包xyz的交易历史”
• “xyz钱包的余额是多少？”
• “更新钱包xyz的元数据”

API速率限制

Privy.io 实施速率限制：

• 用户数据终端每10秒500次请求
• 联系Privy支持团队以增加速率限制

认证

这台服务器使用 HTTP 基本认证 带有自定义头部：

• Authorization: Basic
• privy-app-id:

所有请求均通过HTTPS进行 https://api.privy.io/v1.

支持的区块链网络

• 以太坊及所有与EVM兼容的链
• 索拉纳（Solana）
• 比特币
• Base、Polygon、Arbitrum、Optimism 等更多平台

支持的OAuth提供者

用户可以连接来自15+个提供商的账户：

• 苹果
• Discord（一款即时通讯软件）
• Farcaster（注：这是一个专有名词，直接翻译为“远投器”或“远距传播器”可能无法准确传达其在特定语境下的含义，因此通常保留原名或根据具体语境进行适当解释。在这里，为了保持原文的专有名词特性，直接保留为“Farcaster”。）
• GitHub
• 谷歌
• 领英（LinkedIn）
• Spotify
• Telegram（电报）
• TikTok（抖音国际版）
• Twitter（推特）
• 以及更多

发展

运行测试

pip install -e ".[dev]"
pytest

项目结构

privy-mcp-server/
├── src/
│   └── privy_mcp/
│       ├── __init__.py      # Package initialization
│       ├── client.py        # Privy API client
│       └── server.py        # MCP server implementation
├── pyproject.toml           # Project dependencies
├── .env.example             # Environment template
└── README.md                # Documentation

安全考虑因素

• 永不承诺 .env 文件或公开API凭据
• 使用环境变量或密钥管理功能安全地存储凭据
• API凭据可完全访问您的Privy应用程序
• 这是一个 防御性安全工具 - 不得用于恶意目的
• 审查Privy的安全文档： docs.privy.io/安全（或“安全性”）

故障排除

认证错误

• 验证 PRIVY_APP_ID 并且 PRIVY_APP_SECRET 是正确的
• 在仪表盘 → 应用设置 → 基本信息 中检查凭据
• 确保环境变量已加载

速率限制错误

• 降低请求频率
• 实现指数退避
• 联系Privy支持团队以提高限额

连接错误

• 验证网络连接
• 检查Privy API的状态
• 确保防火墙允许HTTPS请求

资源

• Privy.io 文档
• Privy API 参考手册
• MCP规范
• 私密仪表盘

许可证

MIT 许可证 - 详情请参见 LICENSE 文件

做出贡献

欢迎投稿！请：

1. 为仓库创建分支副本
2. 创建一个特性分支
3. 做出你的更改
4. 如适用，请添加测试
5. 提交一个拉取请求

支持

• 服务器问题:
• “Privy Support”可以翻译为“隐秘支持”或“私下支持”，具体取决于上下文和语境。如果是指在某种不公开或非正式的情况下提供的支持，那么“隐秘支持”可能更贴切；如果是指个人或小团体在私下里给予的帮助或援助，那么“私下支持”可能更合适hi@privy.io（这个邮箱地址直接翻译为中文并无实际意义，通常保持原样使用）
• MCP 规范： 模型上下文协议
• 文档： docs.privy.io（可译为）：Privy的文档网站

免责声明

这是一个非官方的MCP服务器实现。Privy.io已将MCP视为一项新兴技术，并鼓励各方合作。如需用于生产环境，请查阅Privy的官方指南，并通过hi@privy.io联系其团队。

致谢

建立在：

• Privy.io（注：这是一个假设或特定的公司或平台名称，直接翻译为中文可能不具有实际意义，因此保留原英文形式，若需根据上下文具体翻译，需提供更多背景信息。） - Web3钱包基础设施
• 模型上下文协议 - Anthropic的MCP规范
• HTTPX（注：HTTPX可能是一个特定上下文或技术中的术语，直接翻译为“超文本传输安全协议X”并不常见，通常根据具体上下文来确定其准确含义，但在此仅作直译处理） - Python的现代HTTP客户端