Nostr

by abdelstark

26 stars
308 downloads
Not rated
GitHub

About

Integrates with Nostr to enable posting notes and interacting with relays, simplifying decentralized social network engagement and content publishing.

Details

Author
abdelstark
Repository
AbdelStark/nostr-mcp
GitHub stars
26
Downloads
308
License
MIT License
Categories
Developer Tools, Design, AI, Community, Media, Frontend, Automation, Infrastructure, Other

- πŸ“ Post notes to Nostr network
- πŸ”Œ Connect to multiple relays
- πŸ€– MCP-compliant API for AI integration
- πŸ’Έ Send Lightning zaps to Nostr users (WIP)
- πŸ“‘ Server-Sent Events (SSE) support for real-time communication

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Nostr
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

To install Nostr MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @AbdelStark/nostr-mcp --client claude

1. Clone the repository:

git clone https://github.com/AbdelStark/nostr-mcp
cd nostr-mcp

1. Install dependencies:

npm install

1. Create a .env file:

> πŸ’‘ You can copy the .env.example file and modify it as needed.


NODE_ENV=development

bash
npm test
```

post_note

Posts a new note to the Nostr network. Example input: { "content": "Hello from Nostr! πŸ‘‹" }

send_zap

Sends a Lightning zap to a Nostr user. Example input: { "nip05Address": "user@domain.com", "amount": 1000 }

post_note

Posts a new note to the Nostr network.

Example input:

{
  "content": "Hello from Nostr! πŸ‘‹"
}

send_zap

Sends a Lightning zap to a Nostr user.

Example input:

{
  "nip05Address": "user@domain.com",
  "amount": 1000
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "nostr": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

🌐 Nostr MCP Server

A Model Context Protocol (MCP) server that enables AI models to interact with Nostr, allowing them to post notes and interact with the freedom of speech protocol.

Censorship resistance matters, even for LLMs.

smithery badge
TypeScript
MCP
Nostr

BTW, you should join Nostr now!

πŸš€ Features

- πŸ“ Post notes to Nostr network
- πŸ”Œ Connect to multiple relays
- πŸ€– MCP-compliant API for AI integration
- πŸ’Έ Send Lightning zaps to Nostr users (WIP)
- πŸ“‘ Server-Sent Events (SSE) support for real-time communication

πŸ‘·β€β™‚οΈ TODOs

- [ ] Add support for multiple simultaneous connections
- [ ] Implement stdin transport mode (configurable via environment variable)

πŸ“‹ Prerequisites

- Node.js 18+

πŸ› οΈ Installation

Installing via Smithery

To install Nostr MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @AbdelStark/nostr-mcp --client claude

Manual Installation

1. Clone the repository:
git clone https://github.com/AbdelStark/nostr-mcp
cd nostr-mcp

1. Install dependencies:

npm install

1. Create a .env file:

> πŸ’‘ You can copy the .env.example file and modify it as needed.

```env

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.