nostr-mcp

Nostr を安全に探索するための読み取り専用の Model Context Protocol サーバーです。エージェントに、Nostr 識別子の解決、プロフィールやイベントの読み取り、ノートの照会、リレーメタデータの検査を行うためのセマンティックなツールを提供します。

この最初のリリースは、意図的に秘密鍵を受け入れず、イベントを公開しません。署名は、NIP-46 などのリモートサイナーを通じて、明示的なユーザー承認の境界を設けて追加される予定です。

ツール

返されるすべてのイベントには、それを提供したリレーが含まれます。無効な署名は破棄され、重複するイベントはマージされ、部分的なリレー障害は隠蔽されずに報告されます。

要件

• Node.js 20.19 以降

• stdio サーバーをサポートする MCP ホスト

Codex へのインストール

次の 1 つのコマンドでサーバーをインストールして登録します:

npx -y @diegoyegros/nostr-mcp install

登録を確認する:

npx -y @diegoyegros/nostr-mcp doctor
codex mcp list

インストーラーはこの stdio コマンドを Codex に保存します:

npx -y @diegoyegros/nostr-mcp@latest

登録を削除するには:

npx -y @diegoyegros/nostr-mcp uninstall

Codex プラグインとしてインストール

このリポジトリは、MCP サーバーとバンドルされた Nostr スキルを含む Codex プラグインマーケットプレイスでもあります:

codex plugin marketplace add DiegoYegros/nostr-mcp --ref master

Codex を開き、/plugins を実行して、Nostr Plugins を選択し、Nostr MCP をインストールします。このプラグインは読み取り専用で、識別子の解決、公開ノートの照会、イベントの検査、リレーの来歴の報告に関するガイダンスを追加します。

直接の MCP インストーラーとプラグインのインストールは代替手段です。プラグインをインストールすると、バンドルされた MCP サーバーが提供されます。

任意の MCP クライアントで実行

npm パッケージが公開された後、stdio 互換の MCP ホストは次のコマンドで起動できます:

npx -y @diegoyegros/nostr-mcp@latest

MCP クライアント設定の例:

{
  "mcpServers": {
    "nostr": {
      "command": "npx",
      "args": ["-y", "@diegoyegros/nostr-mcp@latest"],
      "env": {
        "NOSTR_RELAYS": "wss://relay.damus.io,wss://nos.lol"
      }
    }
  }
}

ソースから実行

npm install
npm run build
node dist/index.js

ソースチェックアウトを Codex に登録する:

codex mcp add nostr -- "$(command -v node)" "$PWD/dist/index.js"

設定

デフォルトでは、公開された wss:// リレー URL のみが受け入れられます。資格情報、フラグメント、ループバックホスト、またはプライベートネットワークの IP アドレスを含む URL は拒否されます。

ツール呼び出しが relay_urls を指定した場合、そのリレーのみが照会されます。それ以外の場合、設定されたデフォルトの前に、NIP-19 識別子からの安全なリレーヒントが試行されます。

開発

npm run check

チェックには、型チェック、54 のユニットテストと統合テスト、最新の MCP stdio ネゴシエーションスモークテスト、インストーラー CLI、プラグインメタデータの整合性、npm パッケージの内容が含まれます。リレーテストはフェイクリレーと署名済みフィクスチャを使用するため、決定的であり、公開リレーの可用性に依存しません。

公開せずに npm アーティファクトをプレビューする:

npm pack --dry-run

公開

npm 名は @diegoyegros/nostr-mcp です。手動での最初のリリースは次のコマンドで公開できます:

npm login
npm publish --access public

同梱の prepublishOnly フックは、公開前に完全な検証スイートを実行します。以降のリリースは、リポジトリの NPM_TOKEN シークレットを設定した後、GitHub リリースを作成することで自動化できます。リリースワークフローは、npm の来歴情報付きでパッケージを公開します。

セキュリティモデル

• 読み取り専用の MCP ツールアノテーション

• nsec や生の秘密鍵の入力はありません

• イベントがエージェントに到達する前の署名検証

• SSRF リスクを低減するための厳格なリレー URL 検証

• リレー数、結果サイズ、タイムアウトの制限

• クエリ結果におけるリレーの来歴とリレーごとのエラー

報告方法と信頼境界の詳細については、SECURITY.md を参照してください。

ライセンス

MIT