xingfuhoumei/Enterprise-MCP-Server

Enterprise MCP Server

🏢 企业级MCP服务器 - 为企业提供全面的业务工具集

🌟 特性

📁 文件系统管理

• 目录浏览: 详细列出文件和目录信息
• 文件搜索: 支持模式匹配的文件查找
• 备份管理: 安全的文件和目录备份

📊 数据处理

• CSV处理: 分析、筛选、聚合CSV数据
• JSON处理: 结构分析、路径查询、数据验证

🌐 网络工具

• HTTP请求: 支持GET/POST/PUT/DELETE等方法
• API测试: 端点可用性和响应时间测试
• 文件下载: 带进度监控的文件下载

💻 系统监控

• 系统信息: CPU、内存、磁盘使用情况
• 进程监控: 运行进程的实时监控
• 网络连接: 网络连接状态监控

🔐 安全工具

• 哈希计算: 支持MD5/SHA1/SHA256/SHA512
• 文件完整性: 文件哈希验证
• 数据验证: 哈希值匹配验证

🚀 快速开始

安装依赖

pip install mcp requests psutil

运行服务器

python server.py

基本使用

from mcp.client import Client

# 创建客户端连接
client = Client("http://localhost:8000")

# 列出目录内容
result = client.call_tool("list_directory", {"path": "."})

# 处理CSV文件
result = client.call_tool("process_csv", {
    "file_path": "data.csv", 
    "operation": "analyze"
})

# 获取系统信息
result = client.call_tool("system_info", {})

🛠️ 工具列表

📚 资源

🔧 配置

环境变量

• LOG_LEVEL: 日志级别 (默认: INFO)
• HOST: 服务器主机 (默认: 0.0.0.0)
• PORT: 服务器端口 (默认: 8000)

日志配置

默认日志格式：%(asctime)s - %(levelname)s - %(message)s

🔍 示例

文件管理示例

# 列出当前目录
result = client.call_tool("list_directory", {"path": ".", "show_hidden": True})

# 搜索Python文件
result = client.call_tool("find_files", {
    "directory": "/path/to/project",
    "pattern": "*.py",
    "max_results": 50
})

# 创建备份
result = client.call_tool("create_backup", {
    "source_path": "/important/file.txt",
    "backup_path": "/backup/file_backup.txt"
})

数据处理示例

# 分析CSV文件
result = client.call_tool("process_csv", {
    "file_path": "sales_data.csv",
    "operation": "analyze"
})

# 筛选数据
result = client.call_tool("process_csv", {
    "file_path": "sales_data.csv",
    "operation": "filter",
    "column": "region",
    "value": "North"
})

# 聚合计算
result = client.call_tool("process_csv", {
    "file_path": "sales_data.csv",
    "operation": "aggregate",
    "column": "amount"
})

系统监控示例

# 获取系统状态
system_status = client.call_tool("system_info", {})
print(f"CPU使用率: {system_status['cpu']['cpu_usage_percent']}%")

# 监控特定进程
processes = client.call_tool("process_monitor", {
    "process_name": "python",
    "top_n": 5
})

# 检查网络连接
connections = client.call_tool("network_connections", {"port": 8080})

💬 工具调用对话示例

1. 文件系统管理工具

list_directory 工具

用户: 请帮我查看项目根目录的内容，包括隐藏文件

create_backup 工具

用户: 我需要在修改配置文件之前创建备份

find_files 工具

用户: 帮我找到项目中所有的Python测试文件

2. 数据处理和分析工具

process_csv 工具 - 分析操作

用户: 我有一个部门的CSV文件，请帮我分析一下它的结构

process_csv 工具 - 筛选操作

用户: 从销售数据中筛选出所有笔记本电脑的销售记录

process_csv 工具 - 聚合操作

用户: 请计算销售数据中价格字段的统计信息

process_json 工具 - 结构分析

用户: 我有一个复杂的配置JSON文件，请帮我分析它的结构

process_json 工具 - 数据查询

用户: 请获取配置文件中数据库的端口号

3. 网络和API交互工具

http_request 工具 - GET请求

用户: 请帮我从我们的API获取用户列表
助手: 我来调用API获取用户列表。

[调用 http_request]
参数: {"url": "https://api.example.com/users", "method": "GET", "headers": {"Authorization": "Bearer your-token"}}

http_request 工具 - POST请求

用户: 我需要创建一个新用户，请发送POST请求
助手: 我来发送POST请求创建新用户。

[调用 http_request] 
参数: {
  "url": "https://api.example.com/users",
  "method": "POST",
  "headers": {"Content-Type": "application/json"},
  "data": {"name": "张三", "email": "zhangsan@example.com", "role": "user"}
}

创建结果:
- URL: https://api.example.com/users
- 方法: POST  
- 状态码: 201
- 成功: true
- 新用户ID: 12345
- 创建时间: 2024-01-15T15:30:00Z

test_api_endpoint 工具

用户: 请检测我们的API服务是否正常运行
助手: 我来检测API端点的可用性。

[调用 test_api_endpoint]
参数: {"url": "https://api.example.com/health", "expected_status": 200, "timeout": 10}

健康检查结果:
- 端点: https://api.example.com/health
- 状态码: 200 (符合预期)
- 响应时间: 156ms
- 可用性: true
- 测试时间: 2024-01-15T15:35:00
- 服务状态: 健康

download_file 工具

用户: 我需要下载服务器上的数据导出文件
助手: 我来为您下载数据导出文件。

[调用 download_file]
参数: {"url": "https://files.example.com/exports/data-2024-01.zip", "local_path": "./downloads/data-export.zip"}

下载完成:
- 源URL: https://files.example.com/exports/data-2024-01.zip
- 本地路径: /project/downloads/data-export.zip
- 文件大小: 15.7MB
- 下载时间: 8.3秒
- 下载速度: 1.89 MB/s
- 状态: 成功

4. 系统监控和性能工具

system_info 工具

用户: 请检查服务器当前的系统资源使用情况
助手: 我来获取系统资源使用情况。

[调用 system_info]
参数: {}

系统信息:
- CPU使用率: 23.5%
- CPU核心: 8物理核心 / 16逻辑核心
- 内存使用: 45.2% (7.24GB / 16GB)
- 磁盘使用: 62.8% (314GB / 500GB)
- 系统启动时间: 2024-01-12T08:30:00
- 当前频率: 2.4GHz
- 检查时间: 2024-01-15T16:00:00

process_monitor 工具 - 监控特定进程

用户: 请帮我查看所有Python进程的运行状况
助手: 我来监控所有Python相关进程。

[调用 process_monitor]
参数: {"process_name": "python", "top_n": 10}

Python进程监控:
- 总进程数: 5
- 筛选条件: 包含 "python"
- 主要进程:
  1. PID: 1234, python3 - CPU: 15.2%, 内存: 8.5%
  2. PID: 5678, python3 - CPU: 3.1%, 内存: 12.3%  
  3. PID: 9012, python - CPU: 0.5%, 内存: 2.1%
- 检查时间: 2024-01-15T16:05:00

process_monitor 工具 - 查看TOP进程

用户: 显示当前CPU使用率最高的10个进程
助手: 我来显示CPU使用率最高的进程。

[调用 process_monitor]
参数: {"top_n": 10}

TOP 10 CPU使用进程:
1. chrome (PID: 2341) - CPU: 25.8%, 内存: 15.2%
2. node (PID: 3456) - CPU: 18.4%, 内存: 8.7%
3. python3 (PID: 1234) - CPU: 15.2%, 内存: 8.5%
4. mysqld (PID: 7890) - CPU: 8.9%, 内存: 22.1%
5. nginx (PID: 4567) - CPU: 2.3%, 内存: 1.8%
总计监控进程: 156

network_connections 工具 - 监控特定端口

用户: 请检查3000端口的网络连接情况
助手: 我来检查3000端口的连接状态。

[调用 network_connections]  
参数: {"port": 3000}

端口3000连接监控:
- 总连接数: 12
- 筛选端口: 3000
- 活跃连接:
  1. 本地: 127.0.0.1:3000 -> 远程: 127.0.0.1:54321 (ESTABLISHED)
  2. 本地: 0.0.0.0:3000 -> 远程: None (LISTEN)
  3. 本地: 192.168.1.100:3000 -> 远程: 192.168.1.50:45678 (ESTABLISHED)
- 监控时间: 2024-01-15T16:10:00

network_connections 工具 - 查看所有连接

用户: 显示当前系统的网络连接概况
助手: 我来查看系统网络连接概况。

[调用 network_connections]
参数: {}

网络连接概况:
- 总连接数: 247
- 主要连接类型:
  - LISTEN: 18个端口在监听
  - ESTABLISHED: 156个活跃连接  
  - TIME_WAIT: 73个等待关闭的连接
- 常用端口: 80, 443, 3000, 5432, 6379
- 监控时间: 2024-01-15T16:15:00

5. 安全和加密工具

hash_text 工具 - SHA256哈希

用户: 请为我的密码生成SHA256哈希值
助手: 我来为您的文本生成SHA256哈希。

[调用 hash_text]
参数: {"text": "MySecurePassword123!", "algorithm": "sha256"}

哈希结果:
- 原始文本: MySecurePassword123!
- 算法: sha256
- 哈希值: a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3
- 生成时间: 2024-01-15T16:20:00
- 用途: 适用于密码存储和数据完整性验证

hash_text 工具 - MD5哈希

用户: 我需要生成一个文件的MD5校验值
助手: 我来生成MD5哈希值。

[调用 hash_text]
参数: {"text": "Important document content...", "algorithm": "md5"}

MD5哈希结果:
- 原始文本: Important document content...
- 算法: md5
- 哈希值: 5d41402abc4b2a76b9719d911017c592
- 生成时间: 2024-01-15T16:22:00
- 注意: MD5适用于快速校验，但不推荐用于安全用途

hash_file 工具

用户: 请计算这个重要文档的SHA256文件哈希
助手: 我来计算文件的SHA256哈希值。

[调用 hash_file]
参数: {"file_path": "./documents/contract.pdf", "algorithm": "sha256"}

文件哈希结果:
- 文件路径: /project/documents/contract.pdf
- 文件大小: 2,457,856 bytes (2.4MB)
- 算法: sha256  
- 文件哈希: b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9
- 计算时间: 2024-01-15T16:25:00
- 用途: 确保文件传输完整性

verify_hash 工具

用户: 我需要验证下载的文件是否完整，已知的SHA256哈希是 b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9
助手: 我来验证文件内容的哈希值。

[调用 verify_hash]
参数: {
  "text": "文件内容...", 
  "expected_hash": "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9",
  "algorithm": "sha256"
}

哈希验证结果:
- 文本预览: 文件内容...
- 算法: sha256
- 计算得出哈希: b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9
- 预期哈希: b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9
- 验证结果: ✅ 有效 (哈希匹配)
- 验证时间: 2024-01-15T16:30:00

hash_text 工具 - SHA512哈希

用户: 请使用SHA512算法为敏感数据生成更强的哈希
助手: 我来使用SHA512生成更强的哈希值。

[调用 hash_text]
参数: {"text": "sensitive-data-string", "algorithm": "sha512"}

SHA512哈希结果:
- 原始文本: sensitive-data-string
- 算法: sha512
- 哈希值: 9b71d224bd62f3785d96d46ad3ea3d73319bfbc2890caadae2dff72519673ca72323c3d99ba5c11d7c7acc6e14b8c5da0c4663475c2e5c3adef46f73bcdec043
- 生成时间: 2024-01-15T16:32:00  
- 安全级别: 高 (推荐用于敏感数据)