Important Note: This project is archived. It has been superseeded by ContextVM/sdk.
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).
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) |
This monorepo contains the following packages:
The bridge implementation that connects MCP servers to Nostr's DVM ecosystem. Handles tool announcement, execution, and status updates.
A MCP server/discovery service that aggregates MCP tools from DVMs and makes their tools available.
Shared utilities and components used across DVMCP packages.
Prerequisite: Ensure you have Bun installed.
You can run the packages directly using bunx without installing them:
# Run the bridge
bunx dvmcp-bridge
# Run the discovery service
bunx dvmcp-discoveryThe interactive CLI will guide you through configuration setup on first run.
# Install the packages globally
bun install -g @dvmcp/bridge @dvmcp/discovery
# Run the commands
dvmcp-bridge
dvmcp-discoveryFor 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