Affinidi Elements MCP Server

🚀 使用 Affinidi TDK 的 MCP 服務器：為 Affinidi Elements API 構建流式 HTTP 服務器

本項目旨在利用 Model Context Protocol (MCP) 創建一個基於 TypeScript 的流式 HTTP 服務器，用於與 Affinidi Elements API 進行交互。下面將詳細介紹核心概念、功能模塊以及實現細節。

✨ 主要特性

• 利用 MCP 創建流式 HTTP 服務器，實現與 Affinidi Elements API 的交互。
• 涵蓋資源、工具、提示等核心概念，明確系統基本單元和交互邏輯。
• 提供多種核心工具，實現項目信息獲取、登錄配置列舉、電子證書頒發等功能。
• 與配套聊天應用無縫對接，實現身份驗證和電子證書管理。

📦 安裝指南

安裝依賴

npm install mcp-server affinidi-sdk

啟動服務器

node index.js

💻 使用示例

基礎用法

list_project

{
  "project_id": "801a212a-90b1-4463-bfb3-5235181d477d",
  "name": "MCP Project",
  "description": "Default project for MCP server"
}

list_login_configurations

[
  {
    "config_id": "3b1433f3-1886-4a34-9072-7130ef3c3fbb",
    "name": "Eventi",
    "redirect_uris": ["http://localhost:3000/api/auth/callback/affinidi"]
  }
]

vc_issuance_event_ticket

{
  "api_key": "eyJ0eX...",
  "project_id": "801a212a-90b1-4463-bfb3-5235181d477d",
  "given_name": "paramesh",
  "family_name": "kamarthi",
  "email": "paramesh@affinidi.com",
  "event_name": "MCP Event",
  "location": "Banglore",
  "ticket_type": "regular",
  "event_date": "2025-10-01"
}

📚 詳細文檔

核心概念

資源（Resources）

• 定義：資源是 MCP 中的基本單元，代表系統中的實體或數據。
• 屬性：
  • id：唯一標識符
  • type：資源類型（如用戶、設備等）
  • attributes：描述性信息（如名稱、狀態等）

工具（Tools）

• 定義：工具是 MCP 的功能實現模塊，用於處理特定任務。
• 核心工具：
  • list_project：列出項目信息
  • list_login_configurations：獲取登錄配置
  • vc_issuance_event_ticket：頒發活動門票電子證書

提示（Prompts）

• 定義：提示用於定義 MCP 的交互邏輯和規則。
• 特性：
  • 輸入規範
  • 輸出格式
  • 執行上下文

功能模塊

核心工具

1. list_project
   • 功能：獲取項目詳情
2. list_login_configurations
   • 功能：列舉所有登錄配置
3. vc_issuance_event_ticket
   • 功能：頒發活動門票電子證書

應用集成

本項目與配套的聊天應用無縫對接，實現身份驗證和電子證書管理功能。相關代碼託管於 GitHub。

未來規劃

• 任務：將現有的 OpenAPI 規範轉換為 MCP 工具定義

測試指南

運行服務器

node server.js

執行測試用例

npm test

示例輸出

$ node server.js
# 服務器啟動成功，監聽於 http://localhost:3000

$ npm test
# 測試通過，輸出結果如下：
> 列出項目信息：
{ project_id: '801a212a-90b1-4463-bfb3-5235181d477d', name: 'MCP Project' }
> 獲取登錄配置：
[ { config_id: '3b1433f3-1886-4a34-9072-7130ef3c3fbb', name: 'Eventi' } ]
> 頒發電子證書成功！