DVMCP Discovery

A MCP server implementation that aggregates tools from DVMs across the Nostr network and makes them available through a single interface.

Features

- Discovers MCP tools from DVMs across the Nostr network
- Provides a unified interface to access tools from multiple DVMs
- Tool execution handling and status tracking
- Automatic payment for paid tools using Nostr Wallet Connect (NWC)
- Encrypted communication support using NIP-17/NIP-59
- Configurable DVM whitelist
- Direct connection to specific providers or servers
- Interactive mode with built-in tools

Configuration

DVMCP Discovery supports multiple configuration methods with a clear priority order: default < file < environment variables < CLI arguments.

$3

When the package is run for the first time, it will use sensible defaults. You can create a configuration file by copying config.example.yml and modifying it:

``bash
cp config.example.yml config.dvmcp.yml
nano config.dvmcp.yml
`

You can also run the configuration wizard to create a configuration file interactively:

`bash
npx dvmcp-discovery --configure
`

To specify a custom configuration file path:

`bash
npx dvmcp-discovery --config-path /path/to/custom/config.dvmcp.yml
`

$3

You can add configuration settings using command-line arguments:

`bash


Set Nostr relay URLs

npx dvmcp-discovery -r wss://relay1.com,wss://relay2.com

or

npx dvmcp-discovery --nostr-relay-urls wss://relay1.com,wss://relay2.com

Set Nostr private key

npx dvmcp-discovery --nostr-private-key

Enable interactive mode with built-in tools

npx dvmcp-discovery -i

or

npx dvmcp-discovery --interactive

Run in interactive mode without connecting to any relays

npx dvmcp-discovery --interactive

Set MCP service details

npx dvmcp-discovery --mcp-name "My DVMCP Service" --mcp-version "1.2.0"

Limit the number of DVMs to discover

npx dvmcp-discovery --discovery-limit 5

Enable verbose output

npx dvmcp-discovery -v

or

npx dvmcp-discovery --verbose
`

$3

You can also configure the service using environment variables:

// TODO: Add environment variables

$3

To enable automatic payment for tools that require payment, add the NWC (Nostr Wallet Connect) configuration to your config.dvmcp.yml file:

`yaml
nwc:
# Your NWC connection string
# Format: nostr+walletconnect:?relay=&secret=
connectionString: 'nostr+walletconnect:your_wallet_pubkey_here?relay=wss%3A%2F%2Frelay.example.com&secret=your_secret_here'

Feature flags for enabling/disabling specific features


featureFlags:
# Enable interactive mode to load built-in tools and skip default relay connections
interactive: false
`

You can obtain an NWC connection string from compatible wallets like Alby or Coinos. When a tool requires payment, the discovery server will automatically pay the invoice using the configured NWC wallet.

Encryption Support

The DVMCP Discovery enables secure communication through a flexible encryption system. It offers three distinct modes:

- DISABLED: No encryption is used for communication.
- OPTIONAL: (Default) Encrypted and unencrypted messages are accepted, and responses mirror the format of the incoming message. This provides maximum compatibility.
- REQUIRED: Only encrypted communication is accepted and generated, ensuring high security.

For a comprehensive overview of the available encryption modes and their operational behavior, including configuration examples, please refer to the DVMCP Encryption Configuration Guide.

Usage

Prerequisite: Ensure you have Bun installed.

You can run this package directly using npx:

`bash
npx @dvmcp/discovery
`

Alternatively, for development:

`bash
bun run dev
`

For production:

`bash
bun run start
`

$3

You can connect directly to a specific provider or server without a configuration file:

#### Connect to a Provider

Use the --provider flag followed by an nprofile entity to discover and register all tools from a specific provider:

`bash
bun run start --provider nprofile1...
`

#### Connect to a Server

Use the --server flag followed by an naddr entity to register only the tools from a specific server:

`bash
bun run start --server naddr1...
`

This is useful when you want to work with a specific subset of tools rather than discovering all tools from a provider.

Interactive Mode

Interactive mode enables built-in tools that are only loaded when this mode is active. This provides a more streamlined experience when you want to use the discovery server with just the built-in tools.

`bash


Enable interactive mode

npx dvmcp-discovery --interactive

or

npx dvmcp-discovery -i
`

When interactive mode is enabled:

1. Built-in tools are registered and available for use
2. If no relay URLs are specified, the server will run without connecting to any Nostr relays
3. This allows for a self-contained experience using only the built-in tools

This is particularly useful for testing or when you want to use the discovery server without relying on external Nostr relays.

Debug

You can enable debug mode by setting the DEBUG environment variable to *:

`bash
DEBUG=* npx @dvmcp/discovery
`

Testing

Run the test suite:

`bash
bun test
``