AI助手MCP服务器

graph TB
    subgraph "AI Clients"
        A[Google Antigravity]
        B[Claude Code]
        C[Claude Desktop]
    end

    subgraph "MCP Protocol Layer"
        D[MCP Server<br/>laptop-assistant]
    end

    subgraph "Tool Modules"
        E[System Tools]
        F[File Tools]
        G[Web Tools]
        H[App Tools]
        I[Utility Tools]
        I2[Desktop Tools]
        J[Safety Module]
    end

    subgraph "Performance Layer"
        P1[Shared HTTP Client]
        P2[Perf Logging]
    end

    subgraph "System Resources"
        K[Windows OS]
        L[File System]
        M[Network/Web]
        N[Applications]
    end

    A -->|stdio/sse| D
    B -->|stdio/sse| D
    C -->|stdio/sse| D

    D --> E
    D --> F
    D --> G
    D --> H
    D --> I
    D --> I2
    D --> J
    D --> P1
    D --> P2

    E --> K
    F --> L
    G --> M
    H --> N
    I --> K
    I --> L

    J -.->|Confirms| E
    J -.->|Confirms| F
    J -.->|Confirms| H

graph LR
    subgraph "server.py"
        A[FastMCP Server]
    end

    subgraph "src/tools/"
        B[system_tools.py<br/>7 tools]
        C[file_tools.py<br/>9 tools]
        D[web_tools.py<br/>3 tools]
        E[app_tools.py<br/>5 tools]
        F[utility_tools.py<br/>4 tools]
        F2[desktop_tools.py<br/>5 tools]
    end

    subgraph "src/"
        G[safety.py<br/>Confirmation System]
        H[security_config.py<br/>Security Hardening]
        I[http_client.py<br/>Connection Pool + Retry]
        J[perf.py<br/>Performance Logging]
    end

    A --> B
    A --> C
    A --> D
    A --> E
    A --> F
    A --> F2
    A --> G
    A --> H
    A --> I
    A --> J

git clone https://github.com/ViswaSrimaan/mcp_servers.git
cd mcp_servers

python -m venv .venv
.venv\Scripts\activate

pip install mcp psutil httpx beautifulsoup4 pyperclip Pillow duckduckgo-search

{
  "mcpServers": {
    "laptop-assistant": {
      "type": "stdio",
      "command": "<path-to-repo>\\.venv\\Scripts\\python.exe",
      "args": [
        "<path-to-repo>\\server.py"
      ]
    }
  }
}

{
  "mcpServers": {
    "laptop-assistant": {
      "type": "stdio",
      "command": "<path-to-repo>\\.venv\\Scripts\\python.exe",
      "args": [
        "<path-to-repo>\\server.py"
      ]
    }
  }
}

{
  "mcpServers": {
    "laptop-assistant": {
      "command": "<path-to-repo>\\.venv\\Scripts\\python.exe",
      "args": [
        "<path-to-repo>\\server.py"
      ]
    }
  }
}

"What's my current CPU and memory usage?"
"Show me the top 10 processes using the most memory"
"What's my battery status?"
"Run the command 'ipconfig /all'"

"List all files in my Documents folder"
"Create a new folder called 'Projects' on my Desktop"
"Search for all Python files in my workspace"
"Read the contents of config.json"

"Search the web for Python best practices"
"Fetch the content from https://example.com"
"Download the file from this URL to my Downloads folder"

"What applications do I have installed?"
"Search for VS Code in available apps"
"Open Notepad"
"Open https://github.com in my browser"

"Send a notification 'Task Complete' with message 'The build finished successfully'"
"Schedule a task 'DailyBackup' to run 'backup.bat' daily at 10:00"
"List all scheduled tasks"
"Get a list of all open windows"

# Set allowed directories (comma-separated)
$env:MCP_ALLOWED_DIRECTORIES = "C:\Users\YourName\Documents,C:\Projects"

sequenceDiagram
    participant AI as AI Assistant
    participant MCP as MCP Server
    participant User as User/System

    AI->>MCP: kill_process(pid=1234)
    MCP->>MCP: Generate confirmation token
    MCP-->>AI: Returns token + warning message
    Note over AI: AI must explicitly confirm
    AI->>MCP: confirm_action(token="abc123")
    MCP->>User: Process terminated
    MCP-->>AI: Success response

mcp_servers/
├── server.py              # Main MCP server entry point (lifespan, health resource, transport)
├── src/
│   ├── __init__.py
│   ├── safety.py          # Confirmation token system
│   ├── security_config.py # Security hardening configuration
│   ├── http_client.py     # Shared HTTP client with connection pooling & retry
│   ├── perf.py            # @timed decorator & logging configuration
│   └── tools/
│       ├── __init__.py
│       ├── system_tools.py    # System info, commands, processes
│       ├── file_tools.py      # File management operations
│       ├── web_tools.py       # Web search, fetch, download
│       ├── app_tools.py       # Application management (winget)
│       ├── utility_tools.py   # Clipboard, screenshots, open apps
│       └── desktop_tools.py   # Desktop automation, notifications, task scheduler
├── test_security.py       # Security test suite
├── SECURITY_REPORT.md     # Security audit report
├── CONTRIBUTING.md        # Contribution guidelines
├── .venv/                 # Python virtual environment
├── .gitignore
└── README.md

cd <path-to-repo>
.venv\Scripts\activate
python server.py

@mcp.tool()
def your_new_tool(param: str) -> str:
    """Description of what the tool does.
    
    Args:
        param: Description of the parameter.
    """
    # Your implementation
    return json.dumps({"result": "success"})