MCP Server Template Ic

This project demonstrates an MCP server supporting Internet Identity authentication, including a complete authentication process and front - end/back - end implementation.

Security Developer tools #Identity Authentication #MCP Protocol #Blockchain #Server - side .TypeScript

rating : 2.5 points

downloads : 15

update time : 2025-04-28

What is MCP Server?

The MCP (Model Context Protocol) Server is a secure backend service that allows AI applications to authenticate users through Internet Identity, enabling protected operations while maintaining user privacy.

How does it work?

The server provides an authentication flow where users can securely verify their identity through a web interface, then grant temporary access to your AI application.

When should I use it?

Ideal for AI applications that need to verify user identity for sensitive operations while maintaining decentralized authentication standards.

Key Features

Secure Authentication FlowImplements a complete OAuth-like flow with Internet Identity for decentralized authentication

MCP Protocol SupportFully compatible with Model Context Protocol for AI application integration

Temporary DelegationCreates time-limited access credentials for enhanced security

Pros and Cons

Advantages

Decentralized authentication through Internet Identity

No need to manage user credentials directly

Temporary access tokens for better security

Standardized protocol for AI application integration

Limitations

Requires user to have Internet Identity

Additional setup needed for the authentication web interface

Currently focused on DFINITY/Internet Computer ecosystem

Getting Started

Set up the server

Configure and launch the MCP server component

Launch the auth interface

Start the React web application for authentication

Integrate with your AI app

Connect your AI application using the MCP protocol

Initiate authentication

Call the authenticate tool from your AI application

Example Use Cases

Personal AI AssistantSecurely access user's personal data after authentication

Premium Content AccessGrant access to premium features after identity verification

Frequently Asked Questions

What is Internet Identity?

How long do the authentication tokens last?

Can I use other authentication methods?

Additional Resources

Internet Identity Documentation

Official documentation for Internet Identity

MCP Protocol Specification

Technical details about the Model Context Protocol

Example Implementation

Sample code repository for this template

🚀 MCP Server Template with Internet Identity Authentication

This project showcases a Model Context Protocol (MCP) server with an Internet Identity authentication process.

🚀 Quick Start

✨ Features

This project demonstrates an MCP server integrated with an Internet Identity authentication process, enabling secure access and interaction between AI clients and the server.

💻 Usage Examples

Basic Usage

The following diagram illustrates the authentication process:

┌────────────────┐     (1) Use authentication tool for authentication     ┌────────────────┐
│                │ ────────────────────────────────> │                │
│                │                                   │                │
│   AI Client    │                                   │   MCP Server   │
│   with MCP Support │                                   │                │
│                │ <─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │                │
└────────────────┘     (6) Authentication result     └────────────────┘
        │                                                     │
        │                                                     │ (2) Open authentication URL
        │                                                     with pubkey and expiration time
        │                                                     ▼
        │                                           ┌────────────────┐
        │                                           │                │
        │                                           │  React Web App │
        │                                           │  (Authentication UI) │
        │                                           │                │
        │                                           └────────────────┘
        │                                                     │
        │                                                     │ (3) User performs identity verification
        │                                                     using Internet Identity
        │                                                     ▼
        │                                           ┌────────────────┐
        │                                           │                │
        │                                           │  Internet Identity │
        │                                           │                │
        │                                           └────────────────┘
        │                                                     │
        │                                                     │ (4) Return delegation
        │                                                     ▼
        │                                           ┌────────────────┐
        │                                           │                │
        │                                           │ React Web App │
        │                                           │ (Authentication UI) │
        │                                           │                │
        │                                           └────────────────┘
        │                                                     │
        │                                                     │ (5) Send delegation
        │                                                     to MCP Server
        ▼                                                     ▼
┌────────────────┐     (7) Call other MCP tools     ┌────────────────┐
│                │ ────────────────────────────────> │                │
│                │                                   │                │
│   AI Client    │                                   │   MCP Server   │
│   with MCP Support │                                   │  Authenticated │
│                │ <─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │                │
└────────────────┘        (8) Tool response        └────────────────┘

Advanced Usage

Here is a detailed explanation of how it works:

Request Authentication: The AI client calls the authenticate tool of the MCP server.
Open Authentication URL: The MCP server opens a browser window displaying an authentication URL with the following information:
- pubkey: The public key for delegation.
- expiration: The expiration time of the delegation (in milliseconds).
User Identity Verification: The React web application (authentication UI) provides an interface for users to verify their identities using Internet Identity.
Delegation Chain Creation: After successful identity verification, the web application generates a delegation chain for the MArké server using the provided public key and expiration time.
Send Delegation to Server: The web application sends the delegation chain back to the specified endpoint of the MCP server.
Authentication Result: The MCP server returns the authentication result to the AI client.
Call Other Tools: The AI client can call other tools on the MCP server, which has already verified the identity.
Tool Response: The MCP server returns corresponding responses based on the requests.

🔧 Technical Details

Project Structure

- mcp-server/：Implementation of the MCP server
- mcp-server-wallet-connect/：React web application for authentication

Featured MCP Services

Gitlab MCP Server

Certified

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

TypeScript

1.8K

5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

598

5 points

Gmail MCP Server

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.

TypeScript

5.3K

4.7 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご