What is Dvmcp

DVMCP is a bridge implementation that connects Model Context Protocol (MCP) servers to Nostr’s Data Vending Machine (DVM) ecosystem, facilitating the discovery and utilization of AI and computational tools through a decentralized network.

Use cases

DVMCP can be used in scenarios where AI and computational tools need to be accessed through a decentralized network, enabling developers to expose their MCP servers as DVMs and aggregate tools from various DVMs.

How to use

To use DVMCP, you can run the packages directly using NPX without installation or install them globally via npm. For setting up a bridge, configure your MCP server path, Nostr private key, and relays. For the discovery service, aggregate MCP tools by configuring the Nostr private key and relays to monitor.

Key features

Key features of DVMCP include the ability to bridge MCP servers with Nostr’s DVM ecosystem, tool announcement, execution, status updates, and a discovery service for aggregating MCP tools.

Where to use

undefined

DVMCP: Data Vending Machine Context Protocol

A monorepo containing packages that bridge Model Context Protocol (MCP) servers with Nostr’s Data Vending Machine (DVM) ecosystem, enabling AI and computational tools to be discovered and utilized via Nostr’s decentralized network.

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

Setting Up a Bridge

To expose your MCP server as a DVM on Nostr:

1. Navigate to the directory where you want to configure the bridge
2. Run: bunx dvmcp-bridge
3. Follow the interactive setup to configure:
   • Your MCP server path
   • Nostr private key (or generate a new one)
   • Relays to connect to
4. The bridge will start and begin proxying requests between Nostr and your MCP server

Setting Up a Discovery Service

To aggregate MCP tools from DVMs:

1. Navigate to your desired directory
2. Run: bunx dvmcp-discovery
3. Follow the setup to configure:
   • Nostr private key
   • Relays to monitor

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