🌐 Nostr Mcp Сервер

Что такое Nostr MCP?

Nostr MCP — это сервер, предназначенный для упрощения взаимодействия с протоколом Nostr. Он позволяет пользователям публиковать заметки, управлять своим контентом и эффективно взаимодействовать с экосистемой Nostr. Этот сервер выступает в роли моста, позволяя беспрепятственную связь и обмен данными в рамках Nostr, что делает его незаменимым инструментом для разработчиков и пользователей, заинтересованных в децентрализованной коммуникации.

Особенности Nostr MCP

• Удобный интерфейс: Nostr MCP предоставляет интуитивно понятный интерфейс, который упрощает процесс публикации заметок и управления взаимодействиями.
• Децентрализованная коммуникация: Основанный на принципах децентрализации, он обеспечивает пользователям контроль над своими данными и взаимодействиями.
• Обновления в реальном времени: Сервер поддерживает обновления в реальном времени, позволяя пользователям получать мгновенные уведомления о своих публикациях и взаимодействиях.
• Открытый исходный код: Nostr MCP является проектом с открытым исходным кодом, что означает, что любой может внести свой вклад в его развитие, обеспечивая непрерывное улучшение и инновации.
• Поддержка нескольких платформ: Он разработан для работы на различных платформах, что делает его доступным для более широкой аудитории.

Как использовать Nostr MCP

1. Установка: Начните с клонирования репозитория Nostr MCP с GitHub. Следуйте инструкциям по установке, указанным в файле README репозитория.
2. Конфигурация: Настройте параметры сервера в соответствии с вашими требованиями. Это может включать настройку учетных записей пользователей, разрешений и других предпочтений.
3. Публикация заметок: После настройки пользователи могут начать публиковать заметки напрямую через интерфейс. Процесс прост и удобен.
4. Взаимодействие с сообществом: Используйте сервер для взаимодействия с другими пользователями, делитесь идеями и участвуйте в обсуждениях, связанных с Nostr.
5. Вклад: Как проект с открытым исходным кодом, вклад приветствуется. Пользователи могут сообщать об ошибках, предлагать функции или даже вносить код для улучшения функциональности сервера.

Часто задаваемые вопросы

В: Какова цель Nostr MCP?

О: Nostr MCP служит сервером для взаимодействия с протоколом Nostr, позволяя пользователям публиковать заметки и участвовать в децентрализованной коммуникации.

В: Бесплатен ли Nostr MCP для использования?

О: Да, Nostr MCP является проектом с открытым исходным кодом, что делает его бесплатным для использования и модификации.

В: Как я могу внести вклад в Nostr MCP?

О: Вы можете внести вклад, сообщая об ошибках, предлагая функции или отправляя улучшения кода через репозиторий на GitHub.

В: Какие платформы поддерживает Nostr MCP?

О: Nostr MCP разработан для совместимости с несколькими платформами, обеспечивая доступность для широкого круга пользователей.

В: Где я могу найти документацию для Nostr MCP?

О: Документацию обычно можно найти в файле README репозитория или в специальном разделе документации на странице проекта 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>