🌐 Server Nostr Mcp

Cos'è Nostr MCP?

Nostr MCP è un server progettato per facilitare le interazioni con il protocollo Nostr. Permette agli utenti di pubblicare note, gestire i propri contenuti e interagire efficacemente con l'ecosistema Nostr. Questo server funge da ponte, consentendo una comunicazione e uno scambio di dati senza soluzione di continuità all'interno del framework Nostr, rendendolo uno strumento essenziale per sviluppatori e utenti interessati alla comunicazione decentralizzata.

Caratteristiche di Nostr MCP

• Interfaccia Intuitiva: Nostr MCP offre un'interfaccia intuitiva che semplifica il processo di pubblicazione di note e gestione delle interazioni.
• Comunicazione Decentralizzata: Basato sui principi della decentralizzazione, garantisce che gli utenti abbiano il controllo sui propri dati e interazioni.
• Aggiornamenti in Tempo Reale: Il server supporta aggiornamenti in tempo reale, consentendo agli utenti di ricevere notifiche istantanee sui propri post e interazioni.
• Open Source: Nostr MCP è open-source, il che significa che chiunque può contribuire al suo sviluppo, garantendo un miglioramento e un'innovazione continui.
• Supporto Multi-Piattaforma: È progettato per funzionare su varie piattaforme, rendendolo accessibile a un pubblico più ampio.

Come Usare Nostr MCP

1. Installazione: Inizia clonando il repository di Nostr MCP da GitHub. Segui le istruzioni di installazione fornite nel file README del repository.
2. Configurazione: Configura le impostazioni del server secondo le tue esigenze. Questo può includere la creazione di account utente, permessi e altre preferenze.
3. Pubblicazione di Note: Una volta configurato, gli utenti possono iniziare a pubblicare note direttamente tramite l'interfaccia. Il processo è semplice e intuitivo.
4. Interazione con la Comunità: Utilizza il server per interagire con altri utenti, condividere idee e partecipare a discussioni relative a Nostr.
5. Contributo: Essendo un progetto open-source, i contributi sono benvenuti. Gli utenti possono segnalare problemi, suggerire funzionalità o persino contribuire con codice per migliorare la funzionalità del server.

Domande Frequenti

D: Qual è lo scopo di Nostr MCP?

R: Nostr MCP funge da server per interagire con il protocollo Nostr, consentendo agli utenti di pubblicare note e partecipare a comunicazioni decentralizzate.

D: Nostr MCP è gratuito da usare?

R: Sì, Nostr MCP è un progetto open-source, rendendolo gratuito da usare e modificare.

D: Come posso contribuire a Nostr MCP?

R: Puoi contribuire segnalando problemi, suggerendo funzionalità o inviando miglioramenti al codice tramite il repository GitHub.

D: Quali piattaforme supporta Nostr MCP?

R: Nostr MCP è progettato per essere compatibile con più piattaforme, garantendo accessibilità a un'ampia gamma di utenti.

D: Dove posso trovare la documentazione per Nostr MCP?

R: La documentazione può solitamente essere trovata nel file README del repository o nella sezione dedicata alla documentazione sulla pagina GitHub del progetto.

🌐 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.

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.

### Log level (debug, info, warn, error)
LOG_LEVEL=debug
### Node environment (development, production)
NODE_ENV=development
### List of Nostr relays to connect to
NOSTR_RELAYS=wss://relay.damus.io,wss://relay.primal.net,wss://nos.lol
### Your Nostr private key (starts with nsec)
NOSTR_NSEC_KEY=your_nsec_key_here
### Server mode (stdio or sse)
SERVER_MODE=sse
### Port for SSE mode
PORT=9000

🚦 Usage

Starting the Server

### Development mode with hot reload
npm run dev

### Production mode
npm start

Available Tools

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
}

🔧 Development

Project Structure

nostr-mcp/
├── src/
│   ├── index.ts        # Main server entry point
│   ├── nostr-client.ts # Nostr client implementation
│   └── types.ts        # TypeScript type definitions
├── .env               # Environment configuration
└── tsconfig.json     # TypeScript configuration

Running Tests

npm test

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Resources

• Join Nostr
• Nostr Manifesto
• Nostr Specifications
• Model Context Protocol
• Visual testing tool for MCP servers
• Awesome MCP Servers
• Awesome MCP Clients
• MCP TypeScript SDK
• Nostr Development Kit (NDK)

📬 Contact

Feel free to follow me if you'd like, using my public key:

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

Or just scan this QR code to find me:

<p align="center"> Made with ❤️ for the Nostr community </p>