Nostr

Подключите Claude и другие LLM к сети Nostr через Nostr! С легкостью получайте профили, заметки и zaps. Поддерживает пользовательские релеи и продвинутые функции.

Социальные сети Разработка API Прочее ★ 36 GitHub (36 ★)

Nostr предоставляет сервер Model Context Protocol (MCP), который наделяет LLM, такие как Claude, возможностью взаимодействовать с децентрализованной социальной сетью Nostr. Он реализует несколько инструментов для получения профилей пользователей, заметок, а также отправленных и полученных Zaps (микроплатежи). Сервер поддерживает форматы ключей hex и npub, спецификацию relay и предлагает расширенные функции, такие как разбор счетов bolt11 и интеллектуальное кэширование для эффективного извлечения данных.

Ключевые особенности

01Предоставляет подробную информацию об отправленных и полученных пользователем Zaps, включая детали платежей

02Поддерживает пользовательскую спецификацию relay для запросов

03Предлагает расширенные функции, такие как разбор счетов bolt11 и интеллектуальная система кэширования

04Извлекает текстовые заметки (kind 1), созданные пользователем

05Получает профили пользователей Nostr по открытому ключу (hex или npub)

Варианты использования

01Предоставление LLM возможности анализировать активность пользователей в сети Nostr.

02Предоставление LLM возможности извлекать и интерпретировать транзакции Zap.

03Предоставление LLM доступа к профилям пользователей Nostr и их обобщение.

Nostr MCP Server

A Model Context Protocol (MCP) server that provides Nostr capabilities to LLMs like Claude.

nostr-mcp-demo.mov

Features

This server implements five tools for interacting with the Nostr network:

getProfile: Fetches a user's profile information by public key
getKind1Notes: Fetches text notes (kind 1) authored by a user
getReceivedZaps: Fetches zaps received by a user, including detailed payment information
getSentZaps: Fetches zaps sent by a user, including detailed payment information
getAllZaps: Fetches both sent and received zaps for a user, clearly labeled with direction and totals

All tools fully support both hex public keys and npub format, with user-friendly display of Nostr identifiers.

Installation

# Clone the repository
git clone https://github.com/austinkelsay/nostr-mcp-server.git
cd nostr-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Connecting to Claude for Desktop

Make sure you have Claude for Desktop installed and updated to the latest version.

Configure Claude for Desktop by editing or creating the configuration file:

For macOS:

vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

For Windows:

notepad %AppData%\Claude\claude_desktop_config.json

Add the Nostr server to your configuration:

{
    "mcpServers": {
        "nostr": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/nostr-mcp-server/build/index.js"
            ]
        }
    }
}

Be sure to replace /ABSOLUTE/PATH/TO/ with the actual path to your project.

Restart Claude for Desktop.

Usage in Claude

Once configured, you can ask Claude to use the Nostr tools by making requests like:

"Show me the profile information for npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"
"What are the recent posts from npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8?"
"How many zaps has npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8 received?"
"Show me the zaps sent by npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"
"Show me all zaps (both sent and received) for npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"

The server automatically handles conversion between npub and hex formats, so you can use either format in your queries. Results are displayed with user-friendly npub identifiers.

Advanced Usage

You can specify custom relays for any query:

"Show me the profile for npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8 using relay wss://relay.damus.io"

You can also specify the number of notes or zaps to fetch:

"Show me the latest 20 notes from npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"

For zap queries, you can enable extra validation and debugging:

"Show me all zaps for npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8 with validation and debug enabled"

Limitations

The server has a default 8-second timeout for queries to prevent hanging
Only public keys in hex format or npub format are supported
Only a subset of relays is used by default

Implementation Details

Native support for npub format using NIP-19 encoding/decoding
NIP-57 compliant zap receipt detection with direction-awareness (sent/received/self)
Advanced bolt11 invoice parsing with payment amount extraction
Smart caching system for improved performance with large volumes of zaps
Total sats calculations for sent/received/self zaps with net balance
Optional NIP-57 validation for ensuring zap receipt integrity
Each tool call creates a fresh connection to the relays, ensuring reliable data retrieval

Troubleshooting

If queries time out, try increasing the QUERY_TIMEOUT value in the source code (currently 8 seconds)
If no data is found, try specifying different relays that might have the data
Check Claude's MCP logs for detailed error information

Default Relays

The server uses the following relays by default:

wss://relay.damus.io
wss://relay.nostr.band
wss://relay.primal.net
wss://nos.lol
wss://relay.current.fyi
wss://nostr.bitcoiner.social

Development

To modify or extend this server:

Edit the index.ts file in the project root
Run npm run build to compile
Restart Claude for Desktop to pick up your changes

Nostr MCP Server

Сервер MCP (Model Context Protocol), который предоставляет Nostr-возможности языковым моделям (например, Claude).

Возможности

Сервер реализует пять инструментов для взаимодействия с сетью Nostr:

getProfile — получение профиля пользователя по публичному ключу.
getKind1Notes — получение текстовых заметок (kind 1) пользователя.
getReceivedZaps — получение zap-платежей, полученных пользователем, с детальной информацией о платеже.
getSentZaps — получение zap-платежей, отправленных пользователем.
getAllZaps — получение всех zap'ов (отправленных и полученных) с явным указанием направления и итоговой суммы.

Все инструменты поддерживают как hex-ключи, так и npub-формат. Идентификаторы отображаются в удобном npub-формате.

Установка

git clone https://github.com/austinkelsay/nostr-mcp-server.git
cd nostr-mcp-server
npm install
npm run build

Настройка для Claude Desktop

Убедитесь, что у вас установлен Claude Desktop (последняя версия) и создайте/отредактируйте файл конфигурации:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %AppData%\Claude\claude_desktop_config.json

Добавьте конфигурацию сервера:

{
  "mcpServers": {
    "nostr": {
      "command": "node",
      "args": ["/АБСОЛЮТНЫЙ/ПУТЬ/К/nostr-mcp-server/build/index.js"]
    }
  }
}

Замените /АБСОЛЮТНЫЙ/ПУТЬ/К/ на фактический путь к проекту. Перезапустите Claude Desktop.

Использование в Claude

После настройки вы можете попросить Claude выполнить запросы, например:

«Покажи профиль для npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8»
«Какие последние посты у npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8?»
«Сколько zap'ов получил npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8?»
«Покажи отправленные zap'ы для npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8»
«Покажи все zap'ы (и отправленные, и полученные) для npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8»

Сервер автоматически конвертирует npub и hex форматы. Результаты отображаются с удобными npub-идентификаторами.

Расширенное использование

Можно указать пользовательские релеи для любого запроса, например: «Покажи профиль для npub1... через relay wss://relay.damus.io».

Также можно задать количество заметок или zap'ов: «Покажи последние 20 заметок от npub1...».

Для zap-запросов можно включить дополнительную валидацию и отладку: «Покажи все zap'ы для npub1... с валидацией и отладкой».

Ограничения

По умолчанию установлен тайм-аут запроса 8 секунд (чтобы избежать зависания).
Поддерживаются только публичные ключи в hex или npub формате.
По умолчанию используется только подмножество релеев.

Детали реализации

Нативная поддержка npub через кодирование/декодирование NIP-19.
Обнаружение zap-квитанций, совместимое с NIP-57, с определением направления (отправленные/полученные/свои).
Парсинг bolt11-инвойсов с извлечением суммы платежа.
Умная система кэширования для повышения производительности при большом количестве zap'ов.
Расчет общего количества сатош для отправленных/полученных/своих zap'ов с выводом чистого баланса.
Опциональная NIP-57 валидация для проверки целостности zap-квитанций.
Каждый вызов инструмента создает новое подключение к релеям для надежности получения данных.

Устранение неполадок

Если запросы превышают тайм-аут, увеличьте значение QUERY_TIMEOUT в исходном коде (сейчас 8 секунд).
Если данные не найдены, попробуйте указать другие релеи, где они могут быть.
Проверяйте MCP-логи Claude для получения подробной информации об ошибках.

Релеи по умолчанию

Сервер использует следующие релеи:

Разработка

Чтобы изменить или расширить сервер:

Отредактируйте файл index.ts в корне проекта.
Запустите npm run build для компиляции.
Перезапустите Claude Desktop, чтобы изменения вступили в силу.

Источник: https://mcpmarket.com/server/nostr-1

Ключевые особенности

Варианты использования

Nostr MCP Server

Features

Installation

Connecting to Claude for Desktop

Usage in Claude

Advanced Usage

Limitations

Implementation Details

Troubleshooting

Default Relays

Development

Nostr MCP Server

Возможности

Установка

Настройка для Claude Desktop

Использование в Claude

Расширенное использование

Ограничения

Детали реализации

Устранение неполадок

Релеи по умолчанию

Разработка

Что такое Nostr MCP Server?

Какие функции предлагает Nostr?

Как подключить Nostr к Claude для Desktop?

Какие запросы можно выполнять с помощью Nostr?

Каковы ограничения использования Nostr?

Getprofile

Parameters

Getkind1Notes

Parameters

Getreceivedzaps

Parameters

Getsentzaps

Parameters

Getallzaps

Parameters

Getlongformnotes

Parameters

Searchnips

Parameters

Sendanonymouszap

Parameters

Convertnip19

Parameters

Analyzenip19

Parameters

Postanonymousnote

Parameters

Createkeypair

Parameters

Createprofile

Parameters

Updateprofile

Parameters

Postnote

Parameters

Createnote

Parameters

Signnote

Parameters

Publishnote

Parameters

Комментарии