Nb MCP Server

nb - mcpはLLMアシスタント向けに設計されたMCPサーバーで、nbコマンドラインツールをラップし、JSONパラメータでノート操作を処理し、shellのエスケープ問題を回避し、明示的なノートブックの指定をサポートし、プロジェクト間でのノート管理を快適にします。

ノートツール知識管理と記憶 #ノート管理 #LLMアシスタント #コマンドラインラッパー #プロジェクトノート .Rust

スコア : 2ポイント

ダウンロード数 : 0

更新時間 : 2026-03-12

サイトを開く

nb - mcpサーバーとは？

nb - mcpは、nbコマンドラインツールに基づくMCPサーバーで、AIアシスタント（Claude、GPTなど）にスマートなノート管理機能を提供します。これは、AIアシスタントが直接コマンドラインツールを使用する際の2つの主要な問題を解決します。コードスニペット内のバッククォートの衝突と、プロジェクトノートブックの管理が不便な点です。JSONパラメータの伝達と明確なノートブックのコンテキストにより、AIアシスタントが安全かつ確実にあなたのノートを管理できるようになります。

nb - mcpの使い方は？

nb - mcpの使用は非常に簡単です。まずnbコマンドラインツールをインストールし、次にnb - mcpサーバーをインストールし、最後にあなたのAIアシスタントの設定に対応するMCPサーバーの設定を追加します。設定が完了すると、あなたのAIアシスタントは自然言語の指示でノートの作成、編集、検索、管理を行うことができます。

適用シーン

nb - mcpは以下のシーンに特に適しています。 1. AIアシスタントと協力してプロジェクトドキュメントを記録する 2. プログラミング時にコードスニペットと解決策を保存する 3. 研究ノートと参考資料を管理する 4. タスクと待办事項を追跡する 5. ウェブブックマークと重要なリンクを保存する

主要機能

安全なコンテンツ処理

JSONパラメータを通じてノートのコンテンツを伝達することで、コードスニペット内のバッククォートが誤って解析されるのを防ぎ、ノートのコンテンツが完全かつ正確であることを保証します。

プロジェクトコンテキスト管理

各プロジェクトに独立したノートブックを設定できるため、ノートの管理がより整理され、異なるプロジェクトのノートが混在するのを防ぎます。

豊富なコマンドセット

ノートの作成、編集、検索、削除、移動などの完全な機能と、待办事項管理やブックマーク保存などの実用的な機能を提供します。

スマートなタグシステム

ノートにタグを付けることをサポートし、標準化されたタグ分類の提案を提供し、関連するノートの整理と検索を容易にします。

自動ノートブック作成

指定されたノートブックが存在しない場合、サーバーが自動的に作成し、手動での初期化は必要ありません。

Git統合

Gitワークツリーを自動的に検出し、異なるワークツリーに対して独立したログと設定管理を提供します。

利点

AIアシスタント向けに最適化され、一般的なコマンド解析問題を回避する

プロジェクトの分離をサポートし、ノートを整然と保つ

ノート管理の様々なニーズをカバーする豊富な機能

自動化されたノートブック管理と設定

問題のトラブルシューティングに便利な詳細なログ記録

既存のnbエコシステムと完全に互換性がある

制限

依存関係としてnbコマンドラインツールを最初にインストールする必要がある

現在は主に技術ユーザーと開発者を対象としている

設定プロセスには一定の技術知識が必要である

グラフィカルインターフェイスをサポートせず、完全にAIアシスタントを通じて操作する

使い方

依存関係のインストール

まず公式ガイドに従ってnbコマンドラインツールをインストールします。nbは強力なノート管理ツールで、nb - mcpはこれに基づいて構築されています。

nb - mcpのインストール

Cargoを通じてnb - mcpサーバーをインストールするか、GitHub Releasesから事前にコンパイルされたバイナリファイルをダウンロードします。

実行パラメータの設定

ノートブックの名前を設定します。環境変数またはコマンドラインパラメータで指定できます。各プロジェクトに異なるノートブックを使用することをお勧めします。

MCPクライアントの設定

あなたのAIアシスタント（Claude Desktopなど）のMCP設定ファイルにnb - mcpサーバーの設定を追加します。

使用開始

設定が完了したら、AIアシスタントを再起動して、自然言語の指示でノートを管理できるようになります。

使用例

プログラミングノートの保存

開発中に、AIアシスタントに重要なコードスニペットと技術的な解決策を保存してもらいます。

プロジェクトの待办事項の管理

nb - mcpを使ってプロジェクトのタスク進捗を追跡し、AIアシスタントにタスクリストの作成と更新をしてもらいます。

研究資料の収集

研究プロジェクトでnb - mcpを使って重要な参考文献とウェブリンクを保存します。

解決策の迅速な検索

技術的な問題に遭遇したときに、以前に記録した関連する解決策を検索します。

よくある質問

nb - mcpと直接nbコマンドラインツールを使用することの違いは何ですか？

nb - mcpを使用するためにnbコマンドを学習する必要がありますか？

異なるプロジェクトのノートをどのように管理しますか？

ノートデータはどこに保存され、安全ですか？

どのAIアシスタントをサポートしていますか？

問題が発生した場合、どのようにトラブルシューティングを行いますか？

🚀 Opencode品質保証用プラグイン

このディレクトリには、Claude Codeフックから移植された、品質保証と開発ワークフローの強制を提供するOpencodeプラグインが含まれています。

🚀 クイックスタート

このテンプレートをダウンストリームプロジェクトにコピーする際の手順は以下の通りです。

プラグインディレクトリに移動する

cd .auxiliary/configuration/coders/opencode/plugin

依存関係をインストールする
```
npm install
```

シンボリックリンクが存在することを確認する

# プロジェクトルートから
ln -sf .auxiliary/configuration/coders/opencode .opencode

プラグインの読み込みを確認する Opencodeは .opencode/plugin/ から自動的にプラグインを読み込みます。

✨ 主な機能

✅ 1. `post-edit-linter.js` (稼働中)

目的：ファイル更新後にリンターを実行します。
イベント：tool.execute.after（edit ツール用）
動作：

hatch コマンドが利用可能かどうかを確認します。
develop Hatch環境が存在するかどうかを確認します。
hatch --env develop run linters を実行します。
リンターが失敗した場合、出力を50行まで切り捨ててエラーをスローします。
条件が満たされない場合（hatchが利用できない）は早期終了します。
注意：file.edited ではなく tool.execute.after を使用しています（LLMによる編集は file.edited をトリガーしません）。

⚠️ 2. `git-commit-guard.js-disabled` (無効 - Opencodeのbashツールの制限)

目的：リンターまたはテストが失敗した場合、gitコミットを防止します。
状態：無効 - Opencodeのbashツールは input.args.command にコマンドを渡しません。問題：プラグインは tool.execute.before をインターセプトしますが、bashツールの場合は input.args が空です。 元の意図：Claude Codeフック pre-bash-git-commit-check の移植版です。

⚠️ 3. `python-environment-guard.js-disabled` (無効 - Opencodeのbashツールの制限)

目的：Bashコマンドでの不適切なPythonの使用を検出します。
状態：無効 - Opencodeのbashツールは input.args.command にコマンドを渡しません。問題：プラグインは tool.execute.before をインターセプトしますが、bashツールの場合は input.args が空です。 元の意図：Claude Codeフック pre-bash-python-check の移植版です。

📦 インストール

上述のクイックスタートの手順を参照してください。

🔧 技術詳細

依存関係

shlex：シェルコマンドの解析（Pythonのshlexモジュールの移植版） - 無効なプラグインで使用されます。
bun：ランタイム（Opencodeによって提供されます）。

移植に関する注意事項

これらのプラグインはClaude Codeフックから移植されており、その成果は様々です。

Claude Codeフック	Opencodeプラグイン	状態	主な変更点
`post-edit-linter`	`post-edit-linter.js`	✅ 稼働中	Python → JavaScript、`subprocess` → BunシェルAPI、`file.edited` ではなく `tool.execute.after` を使用
`pre-bash-git-commit-check`	`git-commit-guard.js-disabled`	⚠️ 無効	ツール名: `Bash` → `bash`、npm `shlex` パッケージを使用。問題：Opencodeのbashツールは `input.args.command` にコマンドを渡しません。
`pre-bash-python-check`	`python-environment-guard.js-disabled`	⚠️ 無効	`shlex` を使用した同じ解析ロジック、正確なエラーメッセージ。問題：Opencodeのbashツールは `input.args.command` にコマンドを渡しません。

重大な発見

Opencodeのbashツールの制限：テスト中に、Opencodeのbashツールが input.args.command（または任意の input.args フィールド）にコマンド文字列を渡さないことがわかりました。bashツールが呼び出されると、input.args オブジェクトは空の {} になります。これにより、プラグインがbashコマンドをインターセプトして分析することができません。

解決策：post-edit-linter.js のみが動作します。なぜなら、edit ツールの tool.execute.after を使用しており、output.metadata.filediff.file にファイル情報が含まれているからです。

エラーメッセージ

すべてのエラーメッセージは、元のClaude Codeフックと正確に一致しています。

リンターの出力を50行まで切り捨てます。
gitコミットをブロックするための「神の警告」。
Pythonの使用に関する警告メッセージ。

💻 使用例

基本的な使用法

プラグインのテスト

ファイル編集テスト：Pythonファイルを編集し、リンターが実行されることを確認します。
gitコミットテスト：git commit -m "test" を試し、チェックが実行されることを確認します。
Python使用テスト：python -c "print('test')" を試し、警告が表示されることを確認します。

📚 ドキュメント

トラブルシューティング

プラグインが読み込まれない場合：

.opencode シンボリックリンクが .auxiliary/configuration/coders/opencode を指していることを確認します。
OpencodeのバージョンがプラグインAPIをサポートしていることを確認します。
依存関係がインストールされていることを確認します（npm install）。

コマンドが見つからないエラー：