DVMCP: Data Vending Machine Context Protocol Server

Overview: What is DVMCP?

DVMCP (Data Vending Machine Context Protocol) is a monorepo containing packages that facilitate the integration of Model Context Protocol (MCP) servers into Nostr's decentralized network. By leveraging DVMCP, AI applications such as Claude Desktop, Continue, and Cursor can discover, execute, and utilize tools through MCP servers, enhancing their functionality within the Nostr ecosystem.

🔧 Core Features & MCP Capabilities

DVMCP primarily consists of three key components:

1. @dvmcp/bridge: This package acts as a bridge between MCP servers and Nostr's DVM network. It handles tool announcement, execution, and status updates, making it easier for AI applications to interact with external tools through MCP.
2. @dvmcp/discovery: A discovery service that aggregates MCP tools from various DVMs and makes them available to subscribers within the network. This service enhances discoverability and usability of MCP tools across different platforms.
3. @dvmcp/commons: Provides shared utilities and components used by the above packages, ensuring consistent functionality and ease of maintenance.

⚙️ MCP Architecture & Protocol Implementation

DVMCP implements the Model Context Protocol (MCP) to enable seamless communication between AI applications and external tools through Nostr's decentralized network. The protocol flow is designed to ensure efficient data transfer and execution, as illustrated by the following Mermaid diagram:

graph TD
    A[AI Application] -->|MCP Client| B[MCP Protocol]
    B --> C[MCP Server]
    C --> D[Data Source/Tool]
    style A fill:#e1f5fe
    style C fill:#f3e5f5
    style D fill:#e8f5e8

MCP Client Compatibility Matrix

To ensure broad compatibility, DVMCP supports integration with several AI applications:

MCP Client	Resources	Tools	Prompts
Claude Desktop	✅	✅	✅
Continue	✅	✅	✅
Cursor	❌	✅	❌

🚀 Getting Started with Installation

Quick Start with NPX (No Installation)

To run the DVMCP packages without installing them, use npx:

# Run the bridge
npx @dvmcp/bridge
# Run the discovery service
npx @dvmcp/discovery

Follow the interactive CLI setup to configure your MCP servers and Nostr credentials.

Global Installation

For those desiring a more straightforward command-line experience, you can install DVMCP globally:

# Install packages globally
npm install -g @dvmcp/bridge @dvmcp/discovery
# Run commands directly
dvmcp-bridge
dvmcp-discovery

💡 Key Use Cases in AI Workflows

Use Case 1: Real-Time Data Analysis

In a financial analytics platform, DVMCP allows an AI application to request real-time stock data from various APIs. The bridge component connects the MCP server with Nostr, ensuring that the AI application can fetch and process this data efficiently.

Implementation:

// Example configuration for fetching real-time stock data
{
  "mcpServers": {
    "stockDataAPI": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-stockdataapi"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  },
  "tools": [
    {
      "type": "fetcher",
      "name": "Real-Time Stock Data",
      "commands": ["stockDataAPI:getLatestPrices"]
    }
  ]
}

Use Case 2: Custom Tool Integration

In a project management tool, DVMCP can integrate custom tools created by third-party developers. The discovery service ensures that these tools are discoverable and can be seamlessly integrated into the AI application's workflow.

🔌 Integration with MCP Clients

DVMCP supports integration with several MCP clients:

• Claude Desktop: Full support for integrating external tools.
• Continue: Full support for executing custom prompts and fetching data.
• Cursor: Limited support focused on tool execution only.

MCP Configuration Sample

{
  "mcpServers": {
    "[server-name]": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-[name]"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  },
  "tools": [
    {
      "type": "fetcher",
      "name": "External Data Fetcher",
      "commands": ["serverName:getData"]
    },
    {
      "type": "executor",
      "name": "Custom Tool Executor",
      "commands": ["serverName:executeTool"]
    }
  ]
}

📊 Performance & Compatibility Matrix

DVMCP is designed to be highly compatible with various AI applications and tools. The following matrix provides an overview of the current compatibility matrix:

MCP Client	Resources	Tools	Prompts
Claude Desktop	✅	✅	✅
Continue	✅	✅	✅
Cursor	❌	✅	❌

🛠️ Advanced Configuration & Security

For developers looking to fine-tune their MCP server configurations, DVMCP offers advanced options:

1. Environment Variables: Set environment variables like API_KEY and NOSTR_PRIVATE_KEY for secure communication.
2. Relays: Configure different Nostr relays for enhanced network resilience.

Example Environment Configuration

{
  "env": {
    "API_KEY": "your-api-key",
    "NOSTR Private Key": "private-key-here"
  }
}

❓ Frequently Asked Questions (FAQ)

1. How does DVMCP enhance AI application integration?
   • DVMCP bridges the gap between MCP servers and Nostr, allowing seamless discovery and execution of tools within a decentralized network.
2. What are the main differences between @dvmcp/bridge and @dvmcp/discovery?
   • @dvmcp/bridge connects your MCP server to Nostr, while @dvmcp/discovery aggregates these tools for broader availability.
3. Can DVMCP be used with other AI applications besides those listed in the compatibility matrix?
   • Yes, DVMCP is designed to support a wide range of applications, though full features may vary depending on specific client capabilities.
4. How can I ensure secure communication between my MCP server and Nostr relays?
   • Utilize environment variables for API keys and private keys, and configure multiple relays for redundancy.
5. What steps should I take to contribute to DVMCP?
   • Review the contributing guidelines, and submit pull requests or create issues as needed.

👨‍💻 Development & Contribution Guidelines

Contributions to DVMCP are welcome! Follow these steps to get started:

1. Clone the Repository: git clone https://github.com/gzuuus/dvmcp.git
2. Install Dependencies: bun install
3. Run in Development Mode:

   bun run dev --cwd packages/dvmcp-bridge
   bun run dev --cwd packages/dvmcp-discovery
   

🌐 MCP Ecosystem & Resources

Explore the broader MCP ecosystem, including related projects and resources:

• Model Context Protocol
• Nostr Protocol

---

By leveraging DVMCP, developers can create robust AI applications that seamlessly integrate with external tools through MCP servers, enhancing functionality and interoperability within the Nostr ecosystem.