DVMCP is a bridge implementation that connects Model Context Protocol (MCP) servers to Nostr's Data Vending Machine (DVM) ecosystem. This bridge enables AI and computational tools exposed through MCP to be discovered and utilized via Nostr's decentralized network.

Overview

The Model Context Protocol provides a standardized way for applications to expose AI capabilities and tools, while Nostr's Data Vending Machines offer a decentralized marketplace for computational services. This bridge brings these two worlds together, allowing:

MCP servers to announce their capabilities on the Nostr network
Nostr clients to discover available MCP tools
Seamless execution of MCP tools through Nostr's DVM protocol
Standardized payment handling

Features

Service Discovery: Automatically announces MCP services using NIP-89
Tool Discovery and Execution: Exposes and executes MCP tools through DVM kind:5910/6910 events
Status Updates: Provides job status and payment handling via kind:7000 events
Error Handling: Comprehensive error handling and status reporting
Payment Flow: Built-in support for Lightning payment processing

Protocol Specification

For detailed information about the DVMCP, see the specification document.

Getting Started

Prerequisites

Bun runtime (v1.2.2 or later)
A running MCP server
Access to Nostr relays

Installation

Clone the repository:

git clone https://github.com/gzuuus/dvmcp.git
cd dvmcp

Install dependencies:

bun install

Create your configuration:

cp .env.example .env

Edit .env with your settings:

Running the Bridge

Development mode with auto-reload:

bun run dev

Production mode:

bun run start

How It Works

The bridge operates in several stages:

Initialization:
- Connects to the specified MCP server
- Announces service availability on Nostr network
- Begins listening for DVM requests
Tool Operations:
- Receives kind:5910 requests from clients for tool listing or execution
- Processes requests based on the 'c' tag command
- Responds with kind:6910 events containing tool catalog or execution results
- Provides status updates via kind:7000 events
Payment Processing:
- Handles payment requirements through kind:7000 events
- Supports Lightning Network payments
- Provides execution status updates

Example Commands

List available tools:

nak event -k 5910 -c '' --tag 'c=list-tools' --tag 'output=application/json' wss://relay.com

Execute a tool:

nak event -k 5910 -c '{"name":"extract","parameters":{"url":"https://nostr.how"}}' --tag 'c=execute-tool' wss://relay.com

Monitor results:

nak req --stream -k 6910 -k 7000 -s "$(date +%s)" wss://relay.com | jq --stream "fromstream(0|truncate_stream(inputs))"

Contributing

Contributions are welcome! Please feel free to submit pull requests, or issues. For major changes, please open an issue first to discuss what you would like to change.

License

MIT License

Acknowledgments

This project builds on several excellent open-source projects: