mcptrace MCPサーバー：Rustで実装、AIアシスタントにLinuxカーネル追跡とeBPF実行機能を提供

たんさく

Mcptrace

Rustで実装されたbpftrace MCPサーバーで、AIアシスタントにLinuxカーネルのトレース機能を提供し、プローブのクエリ、ヘルパー関数の取得、eBPFプログラムの実行などの機能をサポートしています。

監視開発者ツール #カーネルトレース #eBPFツール #Rustサービス #プローブ管理 .Python

スコア : 2.5ポイント

ダウンロード数 : 7.5K

更新時間 : 2025-07-24

サイトを開く

bpftrace MCPサーバーとは？

これはModel Context Protocol (MCP)に基づくサーバーで、AIアシスタントがeBPF技術を通じてLinuxカーネルの活動をトレースできるようにします。システムコールのトレース、カーネルヘルパー関数のクエリなどの機能を提供します。

bpftrace MCPサーバーの使い方は？

簡単なコマンドライン操作でこのサーバーを使用できます。ユーザーは利用可能なトレースプローブをリストアップし、トレースプログラムを実行して結果を取得できます。

適用シーン

Linuxシステムの動作を監視する必要がある開発者やシステム管理者に適しています。例えば、アプリケーションのデバッグやパフォーマンス問題の分析などです。

主な機能

トレースプローブのリスト表示

利用可能なすべてのbpftraceトレースプローブをリスト表示でき、名前でのフィルタリングもサポートします。

ヘルパー関数の表示

bpftraceのヘルパー関数に関する詳細情報を提供します。

トレースプログラムの実行

カスタムのbpftraceトレーススクリプトを実行でき、タイムアウト時間の設定もサポートします。

トレース結果の取得

以前に実行したトレースプログラムの出力結果を非同期で取得します。

利点

高性能：Rustで記述されているため、良好なパフォーマンスを確保します。

型安全：Rust言語の強い型付け特性により、コードの安全性が向上します。

統合が容易：MCPプロトコルを通じてAIアシスタントとやり取りできます。

制限

リアルタイムストリーミング転送はサポートしていません：get_resultメソッドを使って結果をポーリングする必要があります。

パスワード処理が簡単：現在は基本的なパスワード保存方式のみをサポートしています。

永続的なストレージがありません：実行結果は長期間保存されません。

使い方

依存関係のインストール

まず、Rustとbpftraceツールをインストールし、環境を準備します。

サーバーの構築

Cargoを使ってプロジェクトを構築し、実行可能ファイルを生成します。

サーバーの起動

コンパイル後のバイナリファイルを直接実行してサービスを起動します。

トレースプログラムの実行

提供されたAPIを使ってbpftraceトレーススクリプトを実行します。

使用例

システムコールのトレース

特定のトレースプログラムを実行することで、システムコールの動作を監視します。

トレース結果の取得

トレースプログラムを実行した後、IDを使ってその出力内容を取得します。

よくある質問

なぜsudo権限が必要なのですか？

パスワードはどのように処理しますか？

リアルタイムデータ転送はサポートされていますか？

🚀 bpftrace MCP Server: LinuxカーネルをトレースするeBPFを生成する

最小限のMCP（Model Context Protocol）サーバーで、AIアシスタントがbpftraceによるカーネルトレース機能を利用できるようにします。

現在はRustで実装されており、rmcpクレートを使用することで、パフォーマンスと型安全性を向上させています。Pythonによる実装は、git履歴に残っています。

✨ 主な機能

list_probes：オプションでフィルタリングしながら、利用可能なbpftraceプローブをリスト表示します。
list_helpers：bpftraceのヘルパー関数に関する情報を取得します。
exec_program：バッファ付きの出力でbpftraceプログラムを実行します。
get_result：実行結果を非同期で取得します。

📦 インストール

前提条件

Rustがインストールされていない場合は、以下のコマンドでインストールします。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

bpftraceがインストールされていることを確認します。

sudo apt-get install bpftrace  # Ubuntu/Debian
# または
sudo dnf install bpftrace      # Fedora

サーバーをビルドします。

cargo build --release

クイックセットアップ

自動セットアップスクリプトを使用します。

Claude Desktop：./setup/setup_claude.sh
Claude Code：./setup/setup_claude_code.sh

詳細なセットアップ手順と手動構成については、setup/SETUP.mdを参照してください。

🚀 サーバーの実行

直接実行

./target/release/bpftrace-mcp-server

Cargoを通じて実行

cargo run --release

手動構成

Claude DesktopまたはClaude Codeの手動セットアップ手順については、setup/SETUP.mdを参照してください。

💻 使用例

システムコールプローブのリスト表示

await list_probes(filter="syscalls:*read*")

BPFシステム情報の取得

info = await bpf_info()
# システム情報、カーネルヘルパー、機能、マップタイプ、およびプローブタイプを返します

簡単なトレースの実行

result = await exec_program(
    'tracepoint:syscalls:sys_enter_open { printf("%s\\n", comm); }',
    timeout=10
)
exec_id = result["execution_id"]

結果の取得

output = await get_result(exec_id)
print(output["output"])

🔒 セキュリティに関する注意事項

サーバーはbpftraceを使用するためにsudoアクセスが必要です。
パスワードの取り扱い：sudoパスワードを含む.envファイルを作成します。
```
echo "BPFTRACE_PASSWD=your_sudo_password" > .env
```
代替方法：bpftraceに対してパスワードなしのsudoを設定します。
```
sudo visudo
# 追加: your_username ALL=(ALL) NOPASSWD: /usr/bin/bpftrace
```
スクリプトの検証は行われません。安全なスクリプトを生成することをAIクライアントに任せます。
リソース制限：最大実行時間は60秒、バッファは10,000行です。
詳細なセキュリティ構成については、SECURITY.mdを参照してください。