nostrdb-mcp

MCP.Pizza Chef: damus-io

nostrdb-mcp is a Model Context Protocol server that allows large language models to interact with the nostrdb note database using the ndb command line tool. It integrates with local nostrdb data, typically from the Notedeck nostrdb directory, enabling LLMs to perform efficient note queries and retrievals. This server facilitates seamless access to personal or shared note collections for enhanced context-aware AI workflows.

Use This MCP server To

Query local nostrdb notes using natural language via LLMs Integrate nostrdb note search into AI-driven workflows Enable LLMs to access and retrieve notes from Notedeck nostrdb directory Configure Goose to use nostrdb-mcp for extended note querying Create temporary sessions for testing nostrdb queries with LLMs

README

nostrdb-mcp

A Model Context Protocol server for nostrdb.

What?

MCP is a protocol that enables LLMs to interface with tools and systems. This server enables LLMs to use the ndb nostrdb command line tool to make local nostr queries.

By default, it uses your Notedeck nostrdb directory so that it can search notes your notedeck has seen.

Install

Make sure you have ndb on your path by compiling it via the nostrdb repo by typing make ndb and copying it to your path.

Goose

You can configure goose to use this tool:

$ goose configure

When adding a provider, use: npx -y nostrdb-mcp

You can create a temporary session to try it out like so:

$ goose session --with-extension `npm -y nostrdb-mcp`

Example

nostrdb-mcp FAQ

How do I install nostrdb-mcp?
Compile the ndb tool from the nostrdb repo using 'make ndb' and add it to your system path, then install nostrdb-mcp via npm.
Can nostrdb-mcp work with other MCP clients?
Yes, it can be integrated with any MCP client that supports server extensions, such as Goose.
What is the default data source for nostrdb-mcp?
By default, it uses the Notedeck nostrdb directory to access notes your Notedeck has seen.
How do I configure Goose to use nostrdb-mcp?
Run 'goose configure' and add a provider using 'npx -y nostrdb-mcp'.
Is nostrdb-mcp limited to local note databases?
Yes, it primarily queries local nostrdb data accessible via the ndb CLI tool.
Can I test nostrdb-mcp without permanent setup?
Yes, you can create a temporary session with Goose using 'goose session --with-extension `npm -y nostrdb-mcp`'.
What LLM providers can use nostrdb-mcp?
It is provider-agnostic and works with OpenAI, Claude, Gemini, and others supporting MCP.