Binary Reader MCP

🚀 バイナリリーダー MCP（モデルコンテキストプロトコル）サーバー

このサーバーは、様々なバイナリファイルを読み取り、分析するための Model Context Protocol サーバーです。様々なバイナリファイル形式の読み取りと分析ツールを提供しており、現在は Unreal Engine のアセットファイル（.uasset）をサポートしています。

✨ 主な機能

• Unreal Engine の .uasset ファイルを読み取り、分析する
• バイナリファイルのメタデータと構造を抽出する
• ファイル形式を自動検出する
• 新しいバイナリ形式のサポートを追加するための拡張可能なアーキテクチャ

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/berlinbra/binary-reader-mcp.git
cd binary-reader-mcp

2. 仮想環境を作成し、アクティブ化します：

python -m venv venv
source venv/bin/activate  # Windowsの場合：venv\Scripts\activate

3. 依存関係をインストールします：

pip install -r requirements.txt

💻 使用例

基本的な使用法

このサーバーは、Model Context Protocol を通じて複数のツールを提供しています。

1. Unreal アセットファイルの読み取り

# MCPを通じた使用例
tool: read-unreal-asset
arguments:
    file_path: "path/to/your/asset.uasset"

2. 汎用バイナリファイルの読み取り

# MCPを通じた使用例
tool: read-binary-metadata
arguments:
    file_path: "path/to/your/file.bin"
    format: "auto"  # または "unreal", "custom"

📚 ドキュメント

プロジェクト構造

binary-reader-mcp/
├── README.md
├── requirements.txt
├── main.py
├── src/
│   ├── __init__.py
│   ├── binary_reader/
│   │   ├── __init__.py
│   │   ├── base_reader.py
│   │   ├── unreal_reader.py
│   │   └── utils.py
│   ├── api/
│   │   ├── __init__.py
│   │   ├── routes.py
│   │   └── schemas.py
│   └── config.py
└── tests/
    ├── __init__.py
    ├── test_binary_reader.py
    └── test_api.py

新しいバイナリ形式のサポートの追加

新しいバイナリ形式のサポートを追加するには、以下の手順を実行します。

1. BinaryReader を継承した新しいリーダークラスを作成します。
2. 必要なインターフェースメソッド（read_header, read_metadata）を実装します。
3. ファイル形式の自動検出ロジックに新しい形式を追加します。
4. 新しい形式を含むようにツールリストを更新します。

🤝 貢献の方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add some amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. Pull Request を開きます。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。