使用说明
@portals协议/mcp服务器
用于门户协议的MCP服务器-让您的AI代理访问去中心化工具
将您的AI代理(Claude、Cursor等)连接到Solana上的社区构建的API。代理发现链上门户,每次使用以USDC支付,并自动访问工具-无API密钥,无订阅,无人工干预。
快速开始
添加到您的MCP配置中(Claude Desktop、Cursor等):
{
"mcpServers": {
"portals": {
"command": "npx",
"args": ["-y", "@portalsprotocol/mcp-server"],
"env": {
"PORTALS_NETWORK": "devnet",
"PORTALS_WHITELIST": "PORTAL_ID_1,PORTAL_ID_2"
}
}
}
}
浏览可用门户:https://portalsprotocol.com/browse
你的代理人能做什么
示例门户(由社区构建):
- 社交媒体API(搜索、发布、分析)
- 图像生成(各种型号和样式)
- 数据分析(图表、见解、报告)
- Web抓取(提取、解析、结构化)
每个门户都是一个具有多个相关工具的产品。代理商每次使用以美元支付。没有订阅。没有账户。
运作原理
- 第一轮: 自动创建钱包
~/.portals/wallet.json - 资金钱包: 将SOL(天然气)+USDC(付款)发送到显示的地址
- 白名单门户: 添加要使用的门户ID
- 代理人接管: 发现工具,自主支付,执行
设置后无人机交互。
配置
必需
PORTALS_WHITELIST -逗号分隔的门户ID可启用:
"PORTALS_WHITELIST": "ABC123...,DEF456..."
查找门户ID:https://portalsprotocol.com/browse
可选的
PORTALS_NETWORK -要使用的链(默认值: devnet)
"PORTALS_NETWORK": "devnet"
PORTALS_RPC -自定义RPC终结点(默认:公共Solana RPC)
"PORTALS_RPC": "https://your-rpc.example.com"
首次运行
第一次执行时,服务器:
- 创建
~/.portals/目录 - 生成新钱包→
~/.portals/wallet.json - 显示钱包地址和余额
- 如果需要,显示资金说明
输出示例:
New wallet created: 7xK9...Abc
Wallet saved to: /Users/you/.portals/wallet.json
💰 Wallet Balance:
SOL: 0
USDC: 0
⚠️ WARNING: No SOL for gas fees!
Send SOL to: 7xK9...Abc
Get devnet SOL: https://faucet.solana.com
⚠️ WARNING: No USDC for payments!
Send USDC to: 7xK9...Abc
Portal calls will fail until funded.
特性
- 自动钱包管理 -自动创建并加载钱包
- 多工具支持 -每个门户都可以公开多个工具
- 付款验证 -代理付款前检查链注册表
- 错误驱动的用户体验 -明确的余额警告和资金说明
- 架构缓存 -从门户获取OpenAPI模式
- 输入验证 -根据门户架构验证参数
安全
- 仅限白名单 -代理只能使用您明确启用的门户
- 付款验证 -在发送USDC之前检查链上的付款地址
- 本地钱包 -私钥存储在本地
~/.portals/wallet.json(模式0600) - 开源 -包含完整的TypeScript源代码以供审核
透明度
此包包含完整的TypeScript源代码,以实现完全透明。在连接您的AI代理之前进行审核。
- 来源: github/门户协议/服务器
- 许可证:MIT
- 客户端SDK: @portals协议/客户端
链接
- 网站: https://portalsprotocol.com
- 浏览门户: https://portalsprotocol.com/browse
- 文档: https://portalsprotocol.com/docs
- 问题: https://github.com/portalsprotocol/mcp-server/issues
许可证
MIT©门户协议
