Vincent MCP SDK

Installation

npm install @lit-protocol/vincent-mcp-sdk

Model Context Protocol (MCP) Integration

Overview

The Vincent MCP SDK provides integration with the Model Context Protocol (MCP), allowing developers to transform their Vincent applications into MCP servers. This enables Large Language Models (LLMs) to interact with and operate Vincent abilities on behalf of delegators.

MCP provides a standardized way for LLMs to discover and use abilities, making it easier to build AI-powered applications that can leverage Vincent's capabilities.

Usage

The SDK provides abilities to transform your Vincent application into an MCP server, exposing your abilities to LLMs:

import { ethers } from 'ethers';
import { getVincentAppServer, VincentAppDef } from '@lit-protocol/vincent-mcp-sdk';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

// Create a signer for your delegatee account
const provider = new ethers.providers.JsonRpcProvider(
  'https://mainnet.infura.io/v3/YOUR_INFURA_KEY'
);
const delegateeSigner = new ethers.Wallet('YOUR_DELEGATEE_PRIVATE_KEY', provider);

// Define your Vincent application with abilities
const vincentApp: VincentAppDef = {
  id: '8462368',
  name: 'My Vincent App',
  version: '1',
  abilities: {
    'ipfs-cid-of-ability-1': {
      name: 'sendMessage',
      description: 'Send a message to a user',
      parameters: [
        {
          name: 'recipient',
          type: 'address',
          description: 'Ethereum address of the recipient',
        },
        {
          name: 'message',
          type: 'string',
          description: 'Message content to send',
        },
      ],
    },
    'ipfs-cid-of-ability-2': {
      name: 'checkBalance',
      description: 'Check the balance of an account',
      parameters: [
        {
          name: 'address',
          type: 'address',
          description: 'Ethereum address to check',
        },
      ],
    },
  },
};

// Create an MCP server from your Vincent application
const mcpServer = await getVincentAppServer(delegateeSigner, vincentApp);

// Connect the server to a transport (e.g., stdio for CLI-based LLM abilities)
const stdioTransport = new StdioServerTransport();
await mcpServer.connect(stdioTransport);
// For HTTP-based integration, you can use HTTP transport instead

How It Works

1. Define Your Vincent Application: Create a Vincent application definition with the abilities you want to expose to LLMs.

2. Create an MCP Server: Use getVincentAppServer() to transform your Vincent application into an MCP server.

3. Connect to a Transport: Connect your MCP server to a transport mechanism (stdio, HTTP, etc.) to allow LLMs to communicate with it.

4. LLM Interaction: LLMs can now discover and use your Vincent abilities through the MCP interface, executing them on behalf of authenticated users.

Benefits

• Standardized Interface: MCP provides a standardized way for LLMs to discover and use your Vincent abilities.
• Delegated Execution: LLMs can execute Vincent abilities on behalf of your app delegator users.
• Flexible Integration: Support for various transport mechanisms allows integration with different LLM platforms and environments.
• Extendability: MCP server can be extended with custom abilities and prompts to suit your specific needs.

Release

Pre-requisites:

• You will need a valid npm account with access to the @lit-protocol organization.

Then run pnpm release on the repository root. It will prompt you to update the Vincent MCP SDK version and then ask you to confirm the release. This process will also generate a CHANGELOG.md record with the changes for the release.