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' } ]
> 颁发电子证书成功！