dvmcp

Important Note: This project is archived. It has been superseeded by ContextVM/sdk.

DVMCP: Data Vending Machine Context Protocol

DVMCP (Data Vending Machine Context Protocol) is a project that bridges the Model Context Protocol (MCP) with Nostr's Data Vending Machine (DVM) ecosystem. It enables AI and computational services running on MCP servers to be seamlessly discovered, accessed, and utilized via the decentralized Nostr network.

This integration combines MCP's standardized capability framework with Nostr's cryptographically secure and decentralized messaging, offering key advantages:

• Discoverability: MCP servers and their capabilities can be found through the Nostr network without centralized registries.
• Verifiability: Messages are cryptographically signed, ensuring authenticity and integrity.
• Decentralization: No single point of failure for service discovery or communication.
• Protocol Interoperability: Both MCP and DVMs leverage JSON-RPC patterns, facilitating smooth communication.

For a detailed technical specification, refer to the DVMCP Specification (2025-03-26).

Event Kinds

The following Nostr event kinds are defined and used within the DVMCP:

Kind	Description
31316	Server Announcement
31317	Tools List
31318	Resources List
31319	Prompts List
25910	Requests
26910	Responses
21316	Feedback/Notifications
1059	Encrypted Messages (NIP-59 Gift Wrap)

Packages

This monorepo contains the following packages:

@dvmcp/bridge

The bridge implementation that connects MCP servers to Nostr's DVM ecosystem. Handles tool announcement, execution, and status updates.

@dvmcp/discovery

A MCP server/discovery service that aggregates MCP tools from DVMs and makes their tools available.

@dvmcp/commons

Shared utilities and components used across DVMCP packages.

Installation & Usage

Prerequisite: Ensure you have Bun installed.

Quick Start with Bunx (No Installation)

You can run the packages directly using bunx without installing them:

# Run the bridge
bunx dvmcp-bridge
# Run the discovery service
bunx dvmcp-discovery

The interactive CLI will guide you through configuration setup on first run.

Global Installation

# Install the packages globally
bun install -g @dvmcp/bridge @dvmcp/discovery
# Run the commands
dvmcp-bridge
dvmcp-discovery

Development

For contributors to this repository:

# Clone the repo
git clone https://github.com/gzuuus/dvmcp.git
cd dvmcp
# Install dependencies
bun install
# Start the bridge in development mode
bun run dev --cwd packages/dvmcp-bridge
# Start the discovery service in development mode
bun run dev --cwd packages/dvmcp-discovery