home / mcp / nostrdb mcp server
Allows LLMs to query local nostrdb data using the ndb tool via MCP, targeting the Notedeck nostrdb directory.
Configuration
View docs{
"mcpServers": {
"damus-io-nostrdb-mcp": {
"command": "npx",
"args": [
"-y",
"nostrdb-mcp"
]
}
}
}You can run this MCP server to let LLMs access local nostrdb queries via the nostrdb command line tool, using your Notedeck nostrdb directory. This enables powerful, local data querying by keeping data on your machine and exposing it through the MCP interface.
Start by ensuring the MCP client can launch the server that talks to nostrdb. You will invoke the MCP as a local stdio process and provide the command you want to run to start it. Once running, your MCP client can send queries that map to nostrdb commands, enabling the LLM to search notes your Notedeck has seen.
Prerequisites you need on your system before starting:
- Node.js and npm (or npx) available on your PATH.
- The nostrdb tooling built as part of the nostrdb project, with the ndb binary available on your PATH. Build it by running the nostrdb build steps and ensure the ndb binary can be invoked from your shell.
Install and configure the MCP client to connect to this server as described in the following commands.
This MCP server is designed to run locally and uses the nostrdb command line tool (ndb) to perform queries against your Notedeck nostrdb directory. The recommended entry point for the MCP integration is to run the stdio-based server command that the provider uses, which will invoke nostrdb via npx when required by your client.