Empe MCP Server

🚀 人工智能代理

人工智能代理是一個智能系統，可執行特定任務，輔助用戶管理SSI（自我主權身份）憑證，為用戶在身份憑證管理方面提供便利。

🚀 快速開始

📦 安裝依賴

確保已安裝必要的庫：

pip install empsdk python-jose

⚙️ 初始化配置

創建一個基本的配置文件：

export AI_API_KEY='your-api-key-here'

✨ 主要特性

憑證方案管理工具

創建憑證方案

創建一個新的憑證方案，用於定義頒發憑證的結構。

• 參數：
  • 名稱（name）：人類可讀的名稱，例如："ProofOfPurchase"、"IdentityCredential"
  • 類型（type）：唯一的標識符，用於確定頒發的產品
  • 屬性（properties）：JSON格式，定義屬性及其類型和描述
  • 必填字段（requiredFields）：需要包含在憑證中的字段列表

獲取所有憑證方案

檢索系統中所有的憑證方案。

通過ID獲取憑證方案

根據唯一標識符獲取特定的憑證方案。

• 參數：
  • id：要獲取的憑證方案ID，例如："db5a33ae-2eef-41b4-9c74-2ed16c4bb4f4"

刪除憑證方案

永久刪除指定的憑證方案。

• 參數：
  • id：要刪除的憑證方案ID

檢查憑證類型是否存在

檢查指定類型的憑證方案是否已存在。

• 參數：
  • type：要檢查的憑證類型（區分大小寫）

獲取最新版本的憑證類型

根據憑證類型獲取最新的憑證方案版本。

• 參數：
  • type：要查找的憑證類型

憑證頒發工具

為特定接收者創建定向頒發

為指定的接收者DID創建一個憑證頒發請求。

• 參數：
  • type：要頒發的憑證類型（必須與現有方案匹配）
  • credentialSubject：憑證中包含的數據鍵值對
  • recipientDid：接收者的唯一標識符，例如："did:empe:testnet:123abc456def"

創建開放頒發

創建一個任何人都可以申領的憑證頒發請求。

• 參數：
  • type：要頒發的憑證類型（必須與現有方案匹配）
  • credentialSubject：憑證中包含的數據鍵值對

💻 使用示例

基礎用法

示例1：創建憑證方案和頒發憑證

用戶："為我們的高級會員創建一個會員憑證。" 人工智能代理處理流程：

1. 首先檢查是否存在合適的憑證方案：

{
  "name": "schemaExistsByType",
  "parameters": {
    "type": "MembershipCredential"
  }
}

2. 如果不存在，則創建新的憑證方案：

{
  "name": "createSchema",
  "parameters": {
    "name": "MembershipCredential",
    "type": "MembershipCredential"
  }
}

📚 詳細文檔

本指南詳細介紹瞭如何與人工智能代理交互操作，並提供了詳細的API接口說明和使用示例。