AI导哈

统一模型上下文协议服务器

OASIS Unified MCP Server是一个用于与OASIS、OpenSERV和STAR平台交互的统一模型上下文协议服务器，提供读取、创建、写入操作以及智能合约生成等功能。

  • by NextGenSoftwareUK
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 NextGenSoftwareUK/MCP

使用说明

OASIS统一MCP服务器

用于与OASIS、OpenSERV和STAR平台交互的统一模型上下文协议（MCP）服务器。

🚀 快速开始

1.安装依赖项

cd MCP
npm install

2.配置环境

创建一个 .env 文件：

# Copy the example
cp env.example .env

# Edit .env with your settings
# OASIS_API_URL=http://localhost:5000
# OASIS_API_KEY=your_api_key_here (optional)

3.建造

npm run build

4.磨合开发

npm run dev

5.配置光标

创建或编辑 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "oasis-unified": {
      "command": "node",
      "args": ["/Users/maxgershfield/OASIS_CLEAN/MCP/dist/index.js"],
      "env": {
        "OASIS_API_URL": "http://localhost:5000",
        "OASIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

重要提示： 在配置文件中使用绝对路径。

6.重新启动游标

重新启动Cursor IDE以加载MCP服务器。

📋 可用工具

OASIS工具

读取操作

  • oasis_get_avatar -通过ID、用户名或电子邮件获取头像
  • oasis_get_karma -获取化身的业力得分
  • oasis_get_nfts -获取头像的所有NFT
  • oasis_get_nft -按ID获取NFT详细信息
  • oasis_get_wallet -获取头像钱包
  • oasis_get_holon -按ID获取holon（数据对象）
  • oasis_health_check -检查OASIS API运行状况

创建/写入操作✨

  • oasis_register_avatar - 创建 新头像
  • oasis_authenticate_avatar -验证（登录）并获取JWT令牌
  • oasis_mint_nft - 薄荷 Solana上的新NFT
  • oasis_create_nft - 单一命令： 验证→ 闪闪发光的图像→ mint（用于一致的NFT创建）

看 代理商_NFT_MIN_WORKFLOW.md 对于完整的工作流程（单个MCP命令+curl）。

  • oasis_save_holon - 创建或更新 holon（数据对象）
  • oasis_update_avatar - 更新 头像信息
  • oasis_create_wallet - 创建 化身钱包（基本）
  • oasis_create_wallet_full - 创建 带有完整选项的钱包（推荐）
  • oasis_set_default_wallet - 集 头像的默认钱包
  • oasis_send_transaction - 发送 化身/地址之间的令牌

看 WALLET_CREATION_GUIDE.md 获取详细的钱包创建说明。

A2A协议和SERV基础设施工具🤖

完成代理工作流

  1. oasis_authenticate_avatar -作为用户或向导化身（所有者）进行身份验证
  2. oasis_register_avatar -创建代理化身（设置 avatarType: "Agent") - 需要用户/向导的身份验证
  3. oasis_authenticate_avatar -以代理头像身份进行身份验证以获取JWT令牌
  4. oasis_register_agent_capabilities -注册代理服务和技能（代理自行管理）
  5. oasis_register_agent_as_serv_service -在SERV基础架构中注册代理
  6. oasis_discover_agents_via_serv -发现注册代理（无需身份验证）
  7. oasis_get_my_agents -获取经过身份验证的用户拥有的所有代理（需要用户/向导身份验证）

代理发现

  • oasis_get_agent_card -凭身份证领取代理卡
  • oasis_get_all_agents -列出所有A2A代理商
  • oasis_get_agents_by_service -按服务名称查找代理
  • oasis_get_my_agents -获取经过身份验证的用户拥有的代理（需要身份验证）
  • oasis_discover_agents_via_serv -通过SERV基础架构发现代理

代理商注册

  • oasis_register_agent_capabilities -注册代理功能（需要身份验证）
  • oasis_register_agent_as_serv_service -将代理注册为SERV服务（需要auth+功能）

A2A通信

  • oasis_send_a2a_jsonrpc_request -发送JSON-RPC 2.0请求（ping、payment_request等）
  • oasis_get_pending_a2a_messages -获取代理的待处理消息
  • oasis_mark_a2a_message_processed -将邮件标记为已处理

OpenSERV集成

  • oasis_register_openserv_agent -将OpenSERV AI代理注册为A2A代理
  • oasis_execute_ai_workflow -通过A2A协议执行AI工作流程

看 A2A_SERV_INTEGRATION.md 详细文档。

智能合约生成器工具🔨

  • scgen_generate_contract - 生成 基于JSON规范的智能合约
  • scgen_compile_contract - 编译 智能合约源代码
  • scgen_deploy_contract - 部署 编译到区块链的合约
  • scgen_generate_and_compile - 生成和编译 一步到位
  • scgen_get_cache_stats -获取编译缓存统计信息

支持的区块链：

  • 以太坊（Solidity）
  • 索拉纳（锈/锚）

Solana RPC工具⚡

通过RPC直接进行索拉纳区块链操作（绕过OASIS API）：

  • solana_send_sol - 发送 SOL令牌直接通过Solana RPC
  • solana_get_balance - 获取 钱包地址的SOL余额
  • solana_get_transaction - 获取 签名交易详情

看 索拉娜_RPC_ENDPOINTS.md 详细文档。

  • 根（Scrypto）

🧪 测试

直接测试MCP服务器：

# Run in dev mode (with logs)
npm run dev

# In another terminal, test with echo
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npm run dev

🔧 发展

观看模式

npm run watch

为生产而建

npm run build
npm start

📝 游标用法示例

配置后，您可以询问Cursor：

读取操作

  • “获取用户名'testuser'的头像信息”
  • “显示化身ID abc123的所有NFT”
  • “化身xyz789的业力得分是多少？”
  • “检查OASIS API运行状况”

创建/写入操作✨

  • 使用用户名“alice”和电子邮件创建新的头像alice@example.com'，密码'secure123'“
  • “使用元数据URL创建NFT”https://example.com/nft.json'和符号'MYNFT'”
  • 创建一个名为“MyData”、描述为“Test data”的全息图
  • “为头像abc123创建以太坊钱包”
  • “从化身abc123向化身xyz789发送100个令牌”

A2A/SERV操作🤖

  • “发现提供数据分析服务的SERV代理”
  • “获取代理abc-123的代理卡”
  • “注册具有数据分析和Python技能的代理”
  • “向代理xyz-789发送0.01 SOL的付款请求”
  • “显示所有挂起的A2A消息”
  • “执行人工智能工作流来分析这些数据”

智能合约操作🔨

  • “根据此JSON规范生成Solana智能合约：{programName:'token_vesting'，…}”
  • “编译此Solidity合同：[合同代码]”
  • “将此编译好的合约部署到以太坊”
  • “为Solana生成和编译代币归属合同”

🐛 故障排除

未找到MCP服务器

  • 检查路径是否正确 ~/.cursor/mcp.json 是绝对的
  • 验证文件是否存在： ls -la /Users/maxgershfield/OASIS_CLEAN/MCP/dist/index.js
  • 检查文件权限： chmod +x /Users/maxgershfield/OASIS_CLEAN/MCP/dist/index.js

连接错误

  • 验证OASIS API是否正在运行： curl http://localhost:5000/api/health
  • 检查中的环境变量 .env
  • 检查光标日志：查看→ 输出→ MCP

构建错误

  • 确保已安装Node.js 20+： node --version
  • 清除node_modules并重新安装： rm -rf node_modules && npm install

📚 文档

📚 下一步

  • [x]✅ 添加A2A协议和SERV基础设施工具
  • []添加STAR dApp创建工具
  • []添加更多OpenSERV工作流工具

相关 MCP