MCP Dc

GitHub Codespaces配置的NetBox MCP服務器開發環境，包含完整的開發工具鏈和模擬服務

開發者工具 #開發環境 #MCP服務 #NetBox集成 #狀態管理 .Python

評分 : 2分

下載量 : 9.2K

更新時間 : 2025-11-12

打開站點

什麼是NetBox MCP Server?

NetBox MCP Server是一個基於Model Context Protocol (MCP)標準的服務器，專門用於與NetBox網絡基礎設施管理平臺集成。它允許AI助手和應用程序通過標準化的MCP協議訪問和管理網絡設備、IP地址、虛擬電路等網絡資源。

如何使用NetBox MCP Server?

通過GitHub Codespaces可以快速啟動完整的開發環境，系統會自動配置所有必要的服務，包括模擬的NetBox API服務器、Vault密鑰管理器和PostgreSQL數據庫。用戶可以直接開始開發或測試MCP工具功能。

適用場景

適用於網絡自動化、基礎設施管理、DevOps工作流、AI助手集成等場景。特別適合需要即時訪問網絡配置數據和設備信息的應用程序開發。

主要功能

NetBox深度集成

完全集成NetBox API，支持設備管理、IP地址管理、虛擬電路等核心功能

狀態可信度管理

通過PostgreSQL數據庫維護操作狀態的可信度，確保數據一致性

Vault密鑰管理

集成HashiCorp Vault進行安全的密鑰和憑證管理

Codespaces就緒

預配置的GitHub Codespaces開發環境，一鍵啟動完整開發棧

MCP標準兼容

完全符合Model Context Protocol標準，可與任何MCP客戶端集成

優勢

開箱即用的開發環境，無需複雜配置

完整的模擬服務棧，支持離線開發

標準化的MCP協議，易於與其他工具集成

強大的網絡基礎設施管理能力

安全的密鑰管理和狀態跟蹤

侷限性

需要基本的網絡管理知識背景

依賴NetBox API的特定版本

生產環境需要額外的安全配置

部分高級功能需要NetBox企業版許可

如何使用

啟動Codespaces環境

在GitHub倉庫頁面點擊'Code'按鈕，選擇'Codespaces' → 'Create codespace on main'

等待環境初始化

系統會自動設置Python環境、Docker服務和其他依賴組件，大約需要2-3分鐘

驗證服務狀態

檢查所有開發服務是否正常運行，包括NetBox Mock、Vault Mock和數據庫

開始開發或測試

使用提供的測試腳本驗證功能，或開始開發新的MCP工具

使用案例

網絡設備清單查詢

查詢當前網絡中的所有設備及其狀態信息

IP地址管理

查找可用的IP地址或檢查特定IP的分配狀態

虛擬電路配置

創建或查詢站點之間的虛擬電路連接

常見問題

Codespaces環境啟動後服務無法訪問怎麼辦？

數據庫連接失敗如何解決？

測試運行失敗如何調試？

如何添加新的MCP工具？

生產環境部署需要注意什麼？

🚀 NetBox MCP Server v1.0

NetBox MCP Server v1.0 是一個精心設計的 Python MCP（模型上下文協議）服務器，用於訪問 NetBox 基礎設施。它既適合用於教導新手程序員，也可用於生產環境。

🚀 快速開始

前提條件

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"

✨ 主要特性

核心功能

NetBox API 集成：可全面訪問設備、虛擬機、IP 地址和 VLAN。
HashiCorp Vault 集成：通過 AppRole 認證實現即時（JIT）令牌生成。
PostgreSQL 狀態可信度：查詢模塊引用 muse 確定性模式。
MCP 工具：提供全面的基礎設施管理工具集。

高級功能

結構化 JSON 協議：實現組件間的清晰通信。
性能優化：採用連接池、緩存和重試策略。
大語言模型（LLM）優化：進行令牌估計、響應格式化和流式傳輸。

🧪 測試套件

測試成功率達 100%：使用精簡的測試套件，所有測試均通過。

測試覆蓋範圍

✅ 核心 MCP 服務器功能
✅ 結構化 JSON 協議
✅ 端到端工作流
✅ 性能優化
✅ 工具功能（主機、虛擬機、IP 地址、VLAN）
✅ 錯誤處理和邊界情況

🛠️ 開發

運行測試

# 運行所有測試
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/               # 開發容器