MCP Dc

🚀 NetBox MCP Server v1.0

NetBoxインフラストラクチャへのアクセス用に設計された、堅牢で高度に設計されたPython MCP（Model Context Protocol）サーバーです。新しいプログラマー向けの教育用と本番環境での使用に最適です。

✨ 主な機能

コア機能

• NetBox API統合 - デバイス、VM、IPアドレス、VLANへの完全なアクセス
• HashiCorp Vault統合 - AppRole認証によるJITトークン生成
• PostgreSQL状態信頼性 - ミューズ確信スキーマを参照するクエリモジュール
• MCPツール - インフラストラクチャ管理用の包括的なツールセット

高度な機能

• 構造化JSONプロトコル - コンポーネント間の明確な通信
• パフォーマンス最適化 - コネクションプーリング、キャッシング、リトライ戦略
• LLM最適化 - トークン推定、レスポンス整形、ストリーミング

🧪 テストスイート

テスト成功率100% - 合理化されたテストスイートですべてのテストが合格しています。

テストカバレッジ

• ✅ コアMCPサーバー機能
• ✅ 構造化JSONプロトコル
• ✅ エンドツーエンドワークフロー
• ✅ パフォーマンス最適化
• ✅ ツール機能（ホスト、VM、IP、VLAN）
• ✅ エラーハンドリングとエッジケース

🚀 クイックスタート

前提条件

• Python 3.12以上
• NetBoxインスタンス
• HashiCorp Vault
• PostgreSQLデータベース

インストール

# リポジトリをクローンする
git clone https://github.com/fringemonkey/mcp-dc.git
cd mcp-dc

# 依存関係をインストールする
pip install -r requirements.txt
pip install -r requirements-dev.txt

# テストを実行する
python -m pytest tests/ -v

設定

環境変数を設定します：

export NETBOX_URL="http://your-netbox-instance"
export VAULT_ADDR="http://your-vault-instance"
export VAULT_TOKEN="your-vault-token"
export POSTGRES_HOST="localhost"
export POSTGRES_DB="mcp_state"
export POSTGRES_USER="mcp_user"
export POSTGRES_PASSWORD="mcp_password"

🛠️ 開発

テストの実行

# すべてのテストを実行する
python -m pytest tests/ -v

# 特定のテストカテゴリを実行する
python -m pytest tests/ -m unit
python -m pytest tests/ -m integration
python -m pytest tests/ -m performance

# カバレッジを含めて実行する
python -m pytest tests/ --cov=src --cov-report=html

コード品質

# コードを整形する
black src/ tests/
isort src/ tests/

# コードをリントする
flake8 src/ tests/
mypy src/

# セキュリティチェックを行う
bandit -r src/
safety check

📁 プロジェクト構造

mcp-dc/
├── src/                          # ソースコード
│   ├── server.py                 # メインMCPサーバー
│   ├── netbox_client.py          # NetBox APIクライアント
│   ├── vault_client.py           # Vault認証
│   ├── state_confidence.py       # PostgreSQLクライアント
│   ├── structured_protocol.py    # JSONプロトコル
│   ├── llm_optimizer.py         # LLM最適化
│   ├── llm_mcp_server.py        # LLM MCPサーバー
│   ├── structured_mcp_server.py # 構造化MCPサーバー
│   └── tools/                    # MCPツール
│       ├── hosts.py
│       ├── virtual_machines.py
│       ├── ip_addresses.py
│       └── vlans.py
├── tests/                        # テストスイート
│   ├── test_server.py
│   ├── test_llm_optimization.py
│   ├── test_simple_performance.py
│   └── test_structured_protocol.py
├── examples/                     # サンプルスクリプト
├── scripts/                      # ユーティリティスクリプト
├── docs/                         # ドキュメント
└── .devcontainer/               # 開発コンテナ

🔧 MCPツール

ホスト管理

• list_hosts - すべてのデバイスをリストする
• get_host - 特定のデバイスの詳細を取得する
• search_hosts - 条件によるデバイスの検索

仮想マシン管理

• list_vms - すべてのVMをリストする
• get_vm - 特定のVMの詳細を取得する
• list_vm_interfaces - VMインターフェースをリストする

IPアドレス管理

• list_ips - すべてのIPアドレスをリストする
• get_ip - 特定のIPの詳細を取得する
• search_ips - IPアドレスを検索する

VLAN管理

• list_vlans - すべてのVLANをリストする
• get_vlan - 特定のVLANの詳細を取得する
• list_vlan_ips - VLAN内のIPをリストする

🎓 教育的価値

このプロジェクトは以下を教えるために設計されています：

• MCPプロトコル - Model Context Protocolの実装
• API統合 - NetBox、Vault、PostgreSQLの統合
• テスト戦略 - 単体テスト、統合テスト、パフォーマンステスト
• コード品質 - リント、整形、セキュリティ対策
• CI/CD - GitHub Actions、自動テスト
• ドキュメント - 包括的なREADMEとコードコメント

🚀 パフォーマンス

• コネクションプーリング - 効率的なHTTPコネクション
• キャッシング - TTLベースのレスポンスキャッシング
• リトライ戦略 - 失敗時の指数バックオフ
• メモリ効率 - 最適化されたデータ構造
• 並行操作 - 非同期/待機パターン

🔒 セキュリティ

• Vault統合 - 安全なトークン管理
• 入力検証 - パラメータのサニタイズ
• エラーハンドリング - 安全なエラーレスポンス
• セキュリティスキャン - BanditとSafetyによるチェック

📊 モニタリング

• メトリクス収集 - パフォーマンスと使用状況のメトリクス
• ロギング - レベル付きの構造化ロギング
• ヘルスチェック - サービスの可用性監視
• 状態信頼性 - データの信頼性スコアリング

🤝 コントリビューション

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. 新機能に対するテストを追加する
5. すべてのテストが合格することを確認する
6. プルリクエストを送信する

📄 ライセンス

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

🎉 謝辞

• 優れたインフラストラクチャ管理プラットフォームを提供しているNetBoxチーム
• Vaultセキュリティソリューションを提供しているHashiCorp
• 堅牢なデータベースを提供しているPostgreSQLコミュニティ
• MCPプロトコルの貢献者

本番環境へのデプロイ準備完了！ 🚀

バージョン1.0 - テストエラーゼロ、包括的な機能、本番環境での使用が可能