System Information MCP

🚀 開發環境信息 MCP 服務器指南

這是一個基於 Model Context Protocol (MCP) 的開發環境信息收集服務器，它能自動收集並提供開發環境相關的詳細信息，還可與 Cursor 的 MCP 客戶端集成，為開發工作提供便利。

✨ 主要特性

• 信息收集全面：可收集系統相關信息、獲取安裝的軟件和服務、列出可用的 shell 環境、檢查網絡連接狀態、提供 Python 包信息。
• 支持 Markdown 輸出：能生成開發環境信息的 Markdown 文件，方便查看和調試。
• 與 Cursor 集成：Cursor 作為 MCP 客戶端可連接此服務器，自動利用工具增強對開發環境上下文的理解。

📦 安裝指南

要安裝並運行這個 MCP 服務器，請按以下步驟操作：

1. 克隆倉庫：

git clone https://github.com/carterlasalle/system_information_mcp.git
cd system_information_mcp

2. 創建 Python 虛擬環境（推薦）：

python -m venv venv

3. 激活虛擬環境：
   • 在 Linux/macOS 上：

source venv/bin/activate

- **在 Windows 上**：

venv\Scripts\activate

4. 安裝依賴項：

pip install -r requirements.txt

🚀 快速開始

在 Cursor 中的配置

要在 Cursor 中連接此 MCP 服務器，需在 Cursor 的設置中進行如下配置：

1. 打開 Cursor 設置：轉到 Cursor Settings > Features > MCP。
2. 添加新 MCP 服務器：點擊 + Add New MCP Server 按鈕。
3. 配置服務器：填寫以下信息：
   • 類型：stdio
   • 名稱：DevEnvInfoServer（或其他你喜歡的名稱）
   • 命令：輸入運行服務器的命令。若你在 system_information_mcp 目錄中且已激活虛擬環境，可使用：

python claudemcp.py

注意：若 python 不在你的系統 PATH 中，或你使用的是特定的 Python 解釋器，請根據實際情況調整命令。 4. 完成配置：點擊保存以完成 MCP 服務器的添加。

使用說明

1. 啟動服務器：在終端中運行以下命令以啟動 MCP 服務器：

python claudemcp.py

2. 連接到 Cursor：配置完成後，Cursor 將自動連接到該服務器並開始接收開發環境信息。
3. 使用工具：通過調用 MCP 服務器上的工具來獲取所需的信息。例如：
   • 獲取系統信息：system_info
   • 列出安裝的包：list_packages
   • 檢查網絡狀態：network_status

🔧 技術細節

1. MCP 協議：該服務器實現了 MCP 協議，允許 Cursor 的代理與之通信以發現和使用其功能。
2. 標準輸入輸出傳輸：使用 stdio 傳輸方式，通過標準輸入和輸出流與 Cursor 進行通信。
3. 信息收集：當 Cursor 的代理請求信息時，該服務器會執行各種系統命令（使用 subprocess）和 Python 庫 (platform, os, sys, psutil, pyserial, 等) 來獲取開發環境的相關數據。
4. 工具訪問：每個信息類別都作為 MCP 服務器上的一個工具公開。Cursor 的代理可以調用這些工具以檢索特定信息。
5. Markdown 輸出（可選）：該服務器可以選擇生成包含所有收集信息的 Markdown 文件 (development_environment_info.md)，以便更方便地查看和調試。
6. 與 Cursor 集成：Cursor 作為 MCP 客戶端可以連接到此服務器，並自動利用提供的工具來增強其對開發環境上下文的理解。

📚 詳細文檔

注意事項

• 確保服務器和 Cursor 代理之間有良好的網絡連接。
• 定期更新依賴項以保持最佳性能。
• 如果遇到問題，請檢查日誌輸出或查閱官方文檔。

通過以上步驟，你可以輕鬆地將開發環境信息集成到你的工作流程中，並利用這些信息來優化開發體驗。