system-monitor-mcp


Namesystem-monitor-mcp JSON
Version 1.1.4 PyPI version JSON
download
home_pageNone
SummarySystem Monitor MCP Server - 系统监控MCP服务器
upload_time2025-08-13 04:12:00
maintainerNone
docs_urlNone
authorNone
requires_pythonNone
licenseMIT
keywords mcp system monitor server
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # System Monitor MCP

System Monitor MCP 是一个基于 Model Context Protocol (MCP) 的系统监控服务,可以提供系统资源信息,包括 CPU、内存、磁盘、网络和进程等。

## 版本更新 (v1.1.3)

- 🐛 修复了内存信息获取功能中的 `cached` 和 `buffers` 属性错误
- ✅ 优化了内存监控的兼容性,支持不同操作系统
- 🔧 改进了错误处理机制
- 📊 所有功能已通过完整测试验证

## 功能特点

- 实时监控系统资源使用情况
- 提供 CPU 详细信息,包括使用率、频率等
- 提供内存详细信息,包括物理内存和交换内存
- 提供磁盘详细信息,包括分区和 I/O 统计
- 提供网络详细信息,包括接口和流量统计
- 提供进程详细信息,包括 CPU 使用率、内存使用率等
- 支持资源监控,定期返回资源数据

## 安装

```bash
pip install system-monitor-mcp
```

## 使用方法

### 作为 MCP 服务器

在 AI 助手配置中添加以下 MCP 服务器配置:

```json
{
  "mcpServers": {
    "system-monitor-mcp": {
      "timeout": 60,
      "type": "stdio",
      "command": "python",
      "args": [
        "-m",
        "system_monitor_mcp"
      ]
    }
  }
}
```

### 可用工具

- `get_system_info`: 获取系统基本信息,包括 CPU、内存、操作系统等
- `get_cpu_info`: 获取 CPU 详细信息,包括使用率、频率等
- `get_memory_info`: 获取内存详细信息,包括物理内存和交换内存
- `get_disk_info`: 获取磁盘详细信息,包括分区和 I/O 统计
- `get_network_info`: 获取网络详细信息,包括接口和流量统计
- `get_processes_info`: 获取进程详细信息,包括 CPU 使用率、内存使用率等
- `monitor_resource`: 监控系统资源使用情况,定期返回资源数据

## 示例

### 获取系统信息

```python
# 使用 MCP 工具获取系统信息
result = await use_mcp_tool(
    server_name="system-monitor-mcp",
    tool_name="get_system_info",
    arguments={}
)
print(result)
```

### 监控 CPU 使用率

```python
# 监控 CPU 使用率,每 2 秒采集一次,持续 30 秒
result = await use_mcp_tool(
    server_name="system-monitor-mcp",
    tool_name="monitor_resource",
    arguments={
        "resource_type": "cpu",
        "interval": 2,
        "duration": 30
    }
)
print(result)
```

## 依赖

- Python >= 3.8
- psutil >= 5.9.0
- mcp >= 1.0.0
- pydantic >= 2.0.0

## 更新日志

### v1.1.3 (2024-12-19)
- 修复内存信息获取功能的兼容性问题
- 优化了 Windows 系统下的内存监控
- 改进了错误处理和异常捕获
- 完善了测试覆盖率

### v1.1.2
- 基础功能实现
- 支持系统、CPU、内存、磁盘、网络、进程监控

## 许可证

MIT

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "system-monitor-mcp",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "mcp, system, monitor, server",
    "author": null,
    "author_email": "Undoom <kaikaihuhu666@163.com>",
    "download_url": "https://files.pythonhosted.org/packages/d8/d1/02da9fb58b050263437da79e49c5684e7a3f228f3fc347f4ef607d46a48b/system_monitor_mcp-1.1.4.tar.gz",
    "platform": null,
    "description": "# System Monitor MCP\r\n\r\nSystem Monitor MCP \u662f\u4e00\u4e2a\u57fa\u4e8e Model Context Protocol (MCP) \u7684\u7cfb\u7edf\u76d1\u63a7\u670d\u52a1\uff0c\u53ef\u4ee5\u63d0\u4f9b\u7cfb\u7edf\u8d44\u6e90\u4fe1\u606f\uff0c\u5305\u62ec CPU\u3001\u5185\u5b58\u3001\u78c1\u76d8\u3001\u7f51\u7edc\u548c\u8fdb\u7a0b\u7b49\u3002\r\n\r\n## \u7248\u672c\u66f4\u65b0 (v1.1.3)\r\n\r\n- \ud83d\udc1b \u4fee\u590d\u4e86\u5185\u5b58\u4fe1\u606f\u83b7\u53d6\u529f\u80fd\u4e2d\u7684 `cached` \u548c `buffers` \u5c5e\u6027\u9519\u8bef\r\n- \u2705 \u4f18\u5316\u4e86\u5185\u5b58\u76d1\u63a7\u7684\u517c\u5bb9\u6027\uff0c\u652f\u6301\u4e0d\u540c\u64cd\u4f5c\u7cfb\u7edf\r\n- \ud83d\udd27 \u6539\u8fdb\u4e86\u9519\u8bef\u5904\u7406\u673a\u5236\r\n- \ud83d\udcca \u6240\u6709\u529f\u80fd\u5df2\u901a\u8fc7\u5b8c\u6574\u6d4b\u8bd5\u9a8c\u8bc1\r\n\r\n## \u529f\u80fd\u7279\u70b9\r\n\r\n- \u5b9e\u65f6\u76d1\u63a7\u7cfb\u7edf\u8d44\u6e90\u4f7f\u7528\u60c5\u51b5\r\n- \u63d0\u4f9b CPU \u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec\u4f7f\u7528\u7387\u3001\u9891\u7387\u7b49\r\n- \u63d0\u4f9b\u5185\u5b58\u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec\u7269\u7406\u5185\u5b58\u548c\u4ea4\u6362\u5185\u5b58\r\n- \u63d0\u4f9b\u78c1\u76d8\u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec\u5206\u533a\u548c I/O \u7edf\u8ba1\r\n- \u63d0\u4f9b\u7f51\u7edc\u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec\u63a5\u53e3\u548c\u6d41\u91cf\u7edf\u8ba1\r\n- \u63d0\u4f9b\u8fdb\u7a0b\u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec CPU \u4f7f\u7528\u7387\u3001\u5185\u5b58\u4f7f\u7528\u7387\u7b49\r\n- \u652f\u6301\u8d44\u6e90\u76d1\u63a7\uff0c\u5b9a\u671f\u8fd4\u56de\u8d44\u6e90\u6570\u636e\r\n\r\n## \u5b89\u88c5\r\n\r\n```bash\r\npip install system-monitor-mcp\r\n```\r\n\r\n## \u4f7f\u7528\u65b9\u6cd5\r\n\r\n### \u4f5c\u4e3a MCP \u670d\u52a1\u5668\r\n\r\n\u5728 AI \u52a9\u624b\u914d\u7f6e\u4e2d\u6dfb\u52a0\u4ee5\u4e0b MCP \u670d\u52a1\u5668\u914d\u7f6e\uff1a\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"system-monitor-mcp\": {\r\n      \"timeout\": 60,\r\n      \"type\": \"stdio\",\r\n      \"command\": \"python\",\r\n      \"args\": [\r\n        \"-m\",\r\n        \"system_monitor_mcp\"\r\n      ]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### \u53ef\u7528\u5de5\u5177\r\n\r\n- `get_system_info`: \u83b7\u53d6\u7cfb\u7edf\u57fa\u672c\u4fe1\u606f\uff0c\u5305\u62ec CPU\u3001\u5185\u5b58\u3001\u64cd\u4f5c\u7cfb\u7edf\u7b49\r\n- `get_cpu_info`: \u83b7\u53d6 CPU \u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec\u4f7f\u7528\u7387\u3001\u9891\u7387\u7b49\r\n- `get_memory_info`: \u83b7\u53d6\u5185\u5b58\u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec\u7269\u7406\u5185\u5b58\u548c\u4ea4\u6362\u5185\u5b58\r\n- `get_disk_info`: \u83b7\u53d6\u78c1\u76d8\u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec\u5206\u533a\u548c I/O \u7edf\u8ba1\r\n- `get_network_info`: \u83b7\u53d6\u7f51\u7edc\u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec\u63a5\u53e3\u548c\u6d41\u91cf\u7edf\u8ba1\r\n- `get_processes_info`: \u83b7\u53d6\u8fdb\u7a0b\u8be6\u7ec6\u4fe1\u606f\uff0c\u5305\u62ec CPU \u4f7f\u7528\u7387\u3001\u5185\u5b58\u4f7f\u7528\u7387\u7b49\r\n- `monitor_resource`: \u76d1\u63a7\u7cfb\u7edf\u8d44\u6e90\u4f7f\u7528\u60c5\u51b5\uff0c\u5b9a\u671f\u8fd4\u56de\u8d44\u6e90\u6570\u636e\r\n\r\n## \u793a\u4f8b\r\n\r\n### \u83b7\u53d6\u7cfb\u7edf\u4fe1\u606f\r\n\r\n```python\r\n# \u4f7f\u7528 MCP \u5de5\u5177\u83b7\u53d6\u7cfb\u7edf\u4fe1\u606f\r\nresult = await use_mcp_tool(\r\n    server_name=\"system-monitor-mcp\",\r\n    tool_name=\"get_system_info\",\r\n    arguments={}\r\n)\r\nprint(result)\r\n```\r\n\r\n### \u76d1\u63a7 CPU \u4f7f\u7528\u7387\r\n\r\n```python\r\n# \u76d1\u63a7 CPU \u4f7f\u7528\u7387\uff0c\u6bcf 2 \u79d2\u91c7\u96c6\u4e00\u6b21\uff0c\u6301\u7eed 30 \u79d2\r\nresult = await use_mcp_tool(\r\n    server_name=\"system-monitor-mcp\",\r\n    tool_name=\"monitor_resource\",\r\n    arguments={\r\n        \"resource_type\": \"cpu\",\r\n        \"interval\": 2,\r\n        \"duration\": 30\r\n    }\r\n)\r\nprint(result)\r\n```\r\n\r\n## \u4f9d\u8d56\r\n\r\n- Python >= 3.8\r\n- psutil >= 5.9.0\r\n- mcp >= 1.0.0\r\n- pydantic >= 2.0.0\r\n\r\n## \u66f4\u65b0\u65e5\u5fd7\r\n\r\n### v1.1.3 (2024-12-19)\r\n- \u4fee\u590d\u5185\u5b58\u4fe1\u606f\u83b7\u53d6\u529f\u80fd\u7684\u517c\u5bb9\u6027\u95ee\u9898\r\n- \u4f18\u5316\u4e86 Windows \u7cfb\u7edf\u4e0b\u7684\u5185\u5b58\u76d1\u63a7\r\n- \u6539\u8fdb\u4e86\u9519\u8bef\u5904\u7406\u548c\u5f02\u5e38\u6355\u83b7\r\n- \u5b8c\u5584\u4e86\u6d4b\u8bd5\u8986\u76d6\u7387\r\n\r\n### v1.1.2\r\n- \u57fa\u7840\u529f\u80fd\u5b9e\u73b0\r\n- \u652f\u6301\u7cfb\u7edf\u3001CPU\u3001\u5185\u5b58\u3001\u78c1\u76d8\u3001\u7f51\u7edc\u3001\u8fdb\u7a0b\u76d1\u63a7\r\n\r\n## \u8bb8\u53ef\u8bc1\r\n\r\nMIT\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "System Monitor MCP Server - \u7cfb\u7edf\u76d1\u63a7MCP\u670d\u52a1\u5668",
    "version": "1.1.4",
    "project_urls": {
        "Homepage": "https://github.com/undoom/system-monitor-mcp",
        "Issues": "https://github.com/undoom/system-monitor-mcp/issues",
        "Repository": "https://github.com/undoom/system-monitor-mcp"
    },
    "split_keywords": [
        "mcp",
        " system",
        " monitor",
        " server"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "9c8d18e43837d3c054456a293df335cb2d3beb2d7d7b55004d23dac83780e796",
                "md5": "6dd2d6c44c5518884ee1541489daddfe",
                "sha256": "1825ce740d8473920d3de93152e40802ca2dd34f8a18cee156858a8a841345db"
            },
            "downloads": -1,
            "filename": "system_monitor_mcp-1.1.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6dd2d6c44c5518884ee1541489daddfe",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 11723,
            "upload_time": "2025-08-13T04:11:59",
            "upload_time_iso_8601": "2025-08-13T04:11:59.617262Z",
            "url": "https://files.pythonhosted.org/packages/9c/8d/18e43837d3c054456a293df335cb2d3beb2d7d7b55004d23dac83780e796/system_monitor_mcp-1.1.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d8d102da9fb58b050263437da79e49c5684e7a3f228f3fc347f4ef607d46a48b",
                "md5": "32920c7c24d1be5f378a63ed5e5cdff5",
                "sha256": "61ef828cb21b92e52494f9482f66c533861e668f836f709724c35f90e9e77fa1"
            },
            "downloads": -1,
            "filename": "system_monitor_mcp-1.1.4.tar.gz",
            "has_sig": false,
            "md5_digest": "32920c7c24d1be5f378a63ed5e5cdff5",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 11122,
            "upload_time": "2025-08-13T04:12:00",
            "upload_time_iso_8601": "2025-08-13T04:12:00.924041Z",
            "url": "https://files.pythonhosted.org/packages/d8/d1/02da9fb58b050263437da79e49c5684e7a3f228f3fc347f4ef607d46a48b/system_monitor_mcp-1.1.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-13 04:12:00",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "undoom",
    "github_project": "system-monitor-mcp",
    "github_not_found": true,
    "lcname": "system-monitor-mcp"
}
        
Elapsed time: 1.36234s