🚀 开发环境信息 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 代理之间有良好的网络连接。
• 定期更新依赖项以保持最佳性能。
• 如果遇到问题，请检查日志输出或查阅官方文档。

通过以上步骤，你可以轻松地将开发环境信息集成到你的工作流程中，并利用这些信息来优化开发体验。