🌐 Servidor Nostr Mcp

O que é Nostr MCP?

Nostr MCP é um servidor projetado para facilitar interações com o protocolo Nostr. Ele permite que os usuários publiquem notas, gerenciem seu conteúdo e se envolvam com o ecossistema Nostr de forma eficaz. Este servidor atua como uma ponte, permitindo comunicação e troca de dados sem interrupções dentro da estrutura Nostr, tornando-se uma ferramenta essencial para desenvolvedores e usuários interessados em comunicação descentralizada.

Recursos do Nostr MCP

• Interface Amigável: O Nostr MCP fornece uma interface intuitiva que simplifica o processo de publicação de notas e gerenciamento de interações.
• Comunicação Descentralizada: Baseado nos princípios da descentralização, garante que os usuários tenham controle sobre seus dados e interações.
• Atualizações em Tempo Real: O servidor suporta atualizações em tempo real, permitindo que os usuários recebam notificações instantâneas sobre suas postagens e interações.
• Código Aberto: O Nostr MCP é um projeto de código aberto, o que significa que qualquer pessoa pode contribuir para seu desenvolvimento, garantindo melhoria contínua e inovação.
• Suporte Multiplataforma: Ele é projetado para funcionar em várias plataformas, tornando-o acessível a um público mais amplo.

Como Usar o Nostr MCP

1. Instalação: Comece clonando o repositório do Nostr MCP no GitHub. Siga as instruções de instalação fornecidas no arquivo README do repositório.
2. Configuração: Configure as configurações do servidor de acordo com suas necessidades. Isso pode incluir a configuração de contas de usuário, permissões e outras preferências.
3. Publicação de Notas: Uma vez configurado, os usuários podem começar a publicar notas diretamente pela interface. O processo é simples e amigável.
4. Interagindo com a Comunidade: Utilize o servidor para interagir com outros usuários, compartilhar insights e participar de discussões relacionadas ao Nostr.
5. Contribuindo: Como um projeto de código aberto, contribuições são bem-vindas. Os usuários podem relatar problemas, sugerir recursos ou até mesmo contribuir com código para melhorar a funcionalidade do servidor.

Perguntas Frequentes

Q: Qual é o propósito do Nostr MCP?

A: O Nostr MCP serve como um servidor para interagir com o protocolo Nostr, permitindo que os usuários publiquem notas e se envolvam em comunicação descentralizada.

Q: O Nostr MCP é gratuito para usar?

A: Sim, o Nostr MCP é um projeto de código aberto, tornando-o gratuito para usar e modificar.

Q: Como posso contribuir para o Nostr MCP?

A: Você pode contribuir relatando problemas, sugerindo recursos ou enviando melhorias de código através do repositório do GitHub.

Q: Quais plataformas o Nostr MCP suporta?

A: O Nostr MCP é projetado para ser compatível com várias plataformas, garantindo acessibilidade para uma ampla gama de usuários.

Q: Onde posso encontrar a documentação do Nostr MCP?

A: A documentação pode ser encontrada normalmente no arquivo README do repositório ou na seção de documentação dedicada na página do projeto no GitHub.

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