使用说明

项目简介

本项目是一个 Model Context Protocol (MCP) 服务器集合，旨在增强大型语言模型 (LLM) 的能力，使其能够与您的计算机和各种服务进行交互。它包含多个独立的MCP服务器，分别用于：

操作系统控制 (macOS & Windows): 通过自然语言命令控制您的 macOS 或 Windows 系统，例如调节音量、发送通知、锁定计算机等。
日历助手: 管理您的 Google 日历，包括日程安排、查看日程、取消会议等。
提醒事项服务器: 设置和管理提醒事项，并在到期时发送通知。
文件监控器: 监控指定目录的文件变化（创建、修改、删除、移动），并发送通知。
图像分析器: 加载和分析图像文件，并使用 LLM 获取图像描述。
代码分析器: 分析 Python 代码结构，提取函数、类、导入等信息。
文本改进器: 根据指定风格（正式、创意、简洁）改进文本。
屏幕服务器: 截取全屏、选定区域或活动窗口的屏幕截图。
Gmail 助手: 列出邮件、发送邮件、获取邮件详情、搜索邮件。

这些服务器充当 LLM 和本地计算机资源或外部服务之间的桥梁，使得通过自然语言指令来控制您的数字环境成为可能。

主要功能点

多服务器支持: 包含多种功能的独立 MCP 服务器，用户可以根据需要配置和使用。
操作系统集成: 允许 LLM 通过 MCP 服务器控制 macOS 和 Windows 操作系统。
常用工具集成: 集成了日历、邮件、文件系统等常用工具，扩展 LLM 的应用场景。
可扩展性: 项目结构模块化，易于扩展和添加新的 MCP 服务器。
示例客户端: 提供了多种客户端示例 (CLI, GUI, Web, AI助手, 图像分析器应用)，方便用户体验和集成。

安装步骤

克隆仓库:

git clone https://github.com/aviz85/my-first-mcp

进入项目目录:
```
cd my-first-mcp
```

安装依赖:

uv pip install -e .
# 或者使用 pip
pip install -r requirements.txt

服务器配置

要将这些 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端中配置服务器的启动命令。以下以 macOS 系统上的 Calendar Assistant 和 Mac Control 服务器为例，说明如何配置：

{
  "mcpServers": {
    "calendar": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/src/calendar_assistant/server.py"]
    },
    "mac": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/src/mac_control/server.py"]
    }
  }
}

配置信息说明:

'"mcpServers"': 定义要使用的 MCP 服务器的配置信息。
'"calendar"', '"mac"': 服务器名称，您可以自定义，用于在配置中标识不同的服务器。
'"command"': Python 解释器路径。请将 '/path/to/venv/bin/python' 替换为您项目虚拟环境中的 Python 解释器实际路径。这是运行服务器程序的命令。
'"args"': 服务器脚本路径。请将 '/path/to/src/calendar_assistant/server.py' 和 '/path/to/src/mac_control/server.py' 替换为您克隆仓库后，'calendar_assistant' 和 'mac_control' 服务器脚本的实际路径。这是传递给 Python 解释器的参数，指定要运行的服务器脚本。

配置文件位置:

Windows: '%APPDATA%\Claude\claude_desktop_config.json'
macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Linux: '~/.config/Claude/claude_desktop_config.json'

重要提示:

请根据您的操作系统，配置相应的服务器。例如，在 macOS 上，您应该配置 Calendar 和 Mac Control 服务器；在 Windows 上，配置 Calendar 和 Windows Control 服务器。
不要在同一台机器上同时配置 Mac Control 和 Windows Control 服务器。

基本使用方法

启动服务器: MCP 服务器通常由 MCP 客户端启动和管理。配置完成后，当 MCP 客户端（如 Claude Desktop）需要使用 MCP 服务器的功能时，会自动启动配置的服务器。您通常不需要手动启动这些服务器。
通过 MCP 客户端交互: 使用 MCP 客户端（如 Claude Desktop）与 LLM 进行自然语言交互。例如，要使用 Calendar Assistant，您可以对 Claude 说：“明天下午 2 点安排一个团队会议”。如果 Claude Desktop 配置了 Calendar Assistant MCP 服务器，它将使用该服务器与您的 Google 日历交互并安排会议。
根据需求配置服务器: 根据您的操作系统和所需功能，配置相应的 MCP 服务器。例如，如果您需要在 Windows 系统上使用提醒功能，您需要配置 'reminder-server'。

注意事项

API 密钥配置: Calendar Assistant 和 Gmail Assistant 服务器需要 Google API 密钥才能正常工作。请参考项目文档配置 'credentials.json' 文件。
安全风险: 操作系统控制相关的服务器 (Mac Control, Windows Control) 具有较高的安全风险，请谨慎使用，并仅在信任的环境中使用。

关键词