Affinidi Elements MCP Server

🚀 Using the MCP Server with Affinidi TDK: Building a Streaming HTTP Server for Affinidi Elements API

This guide details how to create a TypeScript-based streaming HTTP server using the Model Context Protocol (MCP) to interact with the Affinidi Elements API. It covers core concepts, functional modules, and implementation details.

🚀 Quick Start

Installation

npm install mcp-server affinidi-sdk

Starting the Server

node index.js

✨ Features

Core Concepts

Resources

• Definition: Resources are the basic units in MCP, representing entities or data in the system.
• Attributes:
  • id: A unique identifier.
  • type: The type of the resource (e.g., user, device).
  • attributes: Descriptive information (e.g., name, status).

Tools

• Definition: Tools are the functional implementation modules in MCP, used to handle specific tasks.
• Core Tools:
  • list_project: Lists project information.
  • list_login_configurations: Retrieves login configurations.
  • vc_issuance_event_ticket: Issues electronic certificates for event tickets.

Prompts

• Definition: Prompts are used to define the interaction logic and rules of MCP.
• Features:
  • Input specifications.
  • Output formats.
  • Execution context.

Functional Modules

Core Tools

1. list_project

   • Function: Retrieves project details.
   • Sample Output:

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

2. list_login_configurations

   • Function: Lists all login configurations.
   • Sample Output:

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

3. vc_issuance_event_ticket

   • Function: Issues electronic certificates for event tickets.
   • Input Parameters:

     {
       "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"
     }
     

📚 Documentation

Application Integration

This project seamlessly integrates with the accompanying chat application to implement authentication and electronic certificate management functions. The relevant code is hosted on GitHub.

Future Plans

• Task: Convert the existing OpenAPI specification into MCP tool definitions.

Testing Guide

Running the Server

node server.js

Executing Test Cases

npm test

Sample Output

$ node server.js
# Server started successfully, listening on http://localhost:3000

$ npm test
# Tests passed, output results are as follows:
> Listing project information:
{ project_id: '801a212a-90b1-4463-bfb3-5235181d477d', name: 'MCP Project' }
> Retrieving login configurations:
[ { config_id: '3b1433f3-1886-4a34-9072-7130ef3c3fbb', name: 'Eventi' } ]
> Electronic certificate issued successfully!