DVMCP
Connects MCP servers to Nostr's decentralized network for discovering and executing computational services without centralized registries. This project is archived and superseded by ContextVM/sdk.
Decentralizes computational tool discovery and execution by bridging Nostr's Data Vending Machine ecosystem, enabling distributed service interactions through NIP-89 announcements and direct Nostr event requests.
What it does
- Announce MCP server capabilities on Nostr network
- Execute tools through decentralized service requests
- Discover available services via Nostr events
- Send cryptographically signed messages
- Bridge MCP JSON-RPC with Nostr DVMs
Best for
About DVMCP
DVMCP is a community-built MCP server published by gzuuus that provides AI assistants with tools and capabilities via the Model Context Protocol. DVMCP decentralizes computational tool discovery with Nostr Data Vending, using NIP-89 for announcing and executing dist It is categorized under ai ml.
How to install
You can install DVMCP in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
DVMCP is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
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
