🌐 Servidor Nostr Mcp

¿Qué es Nostr MCP?

Nostr MCP es un servidor diseñado para facilitar las interacciones con el protocolo Nostr. Permite a los usuarios publicar notas, gestionar su contenido y participar en el ecosistema Nostr de manera efectiva. Este servidor actúa como un puente, permitiendo una comunicación fluida y el intercambio de datos dentro del marco de Nostr, convirtiéndolo en una herramienta esencial para desarrolladores y usuarios interesados en la comunicación descentralizada.

Características de Nostr MCP

• Interfaz Amigable: Nostr MCP proporciona una interfaz intuitiva que simplifica el proceso de publicación de notas y gestión de interacciones.
• Comunicación Descentralizada: Construido sobre los principios de la descentralización, asegura que los usuarios tengan control sobre sus datos e interacciones.
• Actualizaciones en Tiempo Real: El servidor soporta actualizaciones en tiempo real, permitiendo a los usuarios recibir notificaciones instantáneas sobre sus publicaciones e interacciones.
• Código Abierto: Nostr MCP es de código abierto, lo que significa que cualquiera puede contribuir a su desarrollo, asegurando una mejora e innovación continua.
• Soporte Multiplataforma: Está diseñado para funcionar en varias plataformas, haciéndolo accesible a una audiencia más amplia.

Cómo Usar Nostr MCP

1. Instalación: Comienza clonando el repositorio de Nostr MCP desde GitHub. Sigue las instrucciones de instalación proporcionadas en el archivo README del repositorio.
2. Configuración: Configura los ajustes del servidor de acuerdo a tus requisitos. Esto puede incluir la configuración de cuentas de usuario, permisos y otras preferencias.
3. Publicación de Notas: Una vez configurado, los usuarios pueden comenzar a publicar notas directamente a través de la interfaz. El proceso es sencillo y fácil de usar.
4. Interacción con la Comunidad: Utiliza el servidor para interactuar con otros usuarios, compartir ideas y participar en discusiones relacionadas con Nostr.
5. Contribuciones: Como proyecto de código abierto, se aceptan contribuciones. Los usuarios pueden reportar problemas, sugerir características o incluso contribuir con código para mejorar la funcionalidad del servidor.

Preguntas Frecuentes

P: ¿Cuál es el propósito de Nostr MCP?

R: Nostr MCP sirve como un servidor para interactuar con el protocolo Nostr, permitiendo a los usuarios publicar notas y participar en comunicación descentralizada.

P: ¿Es Nostr MCP gratuito para usar?

R: Sí, Nostr MCP es un proyecto de código abierto, lo que lo hace gratuito para usar y modificar.

P: ¿Cómo puedo contribuir a Nostr MCP?

R: Puedes contribuir reportando problemas, sugiriendo características o enviando mejoras de código a través del repositorio de GitHub.

P: ¿Qué plataformas soporta Nostr MCP?

R: Nostr MCP está diseñado para ser compatible con múltiples plataformas, asegurando accesibilidad para una amplia gama de usuarios.

P: ¿Dónde puedo encontrar la documentación de Nostr MCP?

R: La documentación generalmente se puede encontrar en el archivo README del repositorio o en la sección de documentación dedicada en la página de GitHub del proyecto.

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