使用说明

项目简介

本项目 'MCP Server Tools Demo' 是一个基于 Model Context Protocol (MCP) 的服务器示例，旨在演示如何构建和使用 MCP 服务器为大型语言模型 (LLM) 客户端提供扩展功能。它包含一系列实用工具，例如文件管理、天气信息查询和 WhatsApp 聊天分析，使得 LLM 客户端能够调用这些工具来增强其能力。本仓库包含 Claude Desktop 和 Cursor IDE 的集成配置示例，方便用户快速体验 MCP 服务器在实际应用场景中的使用。

主要功能点

文件管理工具：
- 列出目录内容，包括文件和文件夹的详细信息（类型、大小、修改时间）。
- 根据模式匹配搜索文件。
- 读取文本文件内容，支持大文件分块读取。
天气信息工具：
- 获取美国各州的天气警报。
- 根据经纬度获取详细天气预报。
WhatsApp 聊天分析工具：
- 查找 WhatsApp 聊天导出文件。
- 分析聊天记录，生成统计信息（例如消息总数、参与者消息数量排行）。
- 读取 WhatsApp 聊天文件内容。

安装步骤

克隆仓库

git clone https://github.com/ShenSeanChen/launch-mcp-demo.git
cd launch-mcp-demo

创建并激活虚拟环境 (推荐)

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用 venv\Scripts\activate

安装项目依赖
```
pip install -e .
```

服务器配置

要将这些工具作为 MCP 服务器集成到 MCP 客户端（例如 Claude Desktop 或 Cursor IDE），您需要配置客户端以连接到这些服务器。以下分别针对 Claude Desktop 和 Cursor IDE 提供了配置示例。

Claude Desktop 配置

Claude Desktop 通过 'claude_desktop_config.json' 文件配置 MCP 服务器。您需要在以下路径创建或修改此文件：

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

以下是一个配置示例，展示如何配置 'weather' 和 'files' 两个 MCP 服务器：

{
  "mcpServers": {
    "weather": {  // 服务器名称，在 Claude 中用于标识和调用
      "command": "/path/to/your/python/environment",  // Python 解释器路径，请替换为您的 Python 虚拟环境或全局 Python 解释器路径
      "args": [
        "--directory",  // 参数，指定工作目录
        "/path/to/launch-mcp-demo/weather",  // 工作目录路径，请替换为您的 launch-mcp-demo 仓库中 weather 目录的绝对路径
        "run",          // 参数，运行命令
        "weather.py"    // 参数，指定要运行的 Python 脚本
      ]
    },
    "files": {      // 服务器名称，在 Claude 中用于标识和调用
      "command": "/path/to/your/python/environment",  // Python 解释器路径，请替换为您的 Python 虚拟环境或全局 Python 解释器路径
      "args": [
        "--directory",  // 参数，指定工作目录
        "/path/to/launch-mcp-demo/files",    // 工作目录路径，请替换为您的 launch-mcp-demo 仓库中 files 目录的绝对路径
        "run",          // 参数，运行命令
        "files.py"      // 参数，指定要运行的 Python 脚本
      ]
    }
  }
}

配置步骤:

创建 Claude 配置文件目录（如果不存在）。
创建 'claude_desktop_config.json' 配置文件。
更新配置文件中的路径：
- 将 '/path/to/your/python/environment' 替换为您的 Python 解释器路径（可以使用 'which python' 或 'where python' 命令查找）。如果您使用了虚拟环境，请使用虚拟环境中的 Python 解释器路径。
- 将 '/path/to/launch-mcp-demo' 替换为您克隆的 'launch-mcp-demo' 仓库的绝对路径。
重启 Claude Desktop 以应用配置。

Cursor IDE 配置

Cursor IDE 通过项目根目录下的 '.cursor/mcp.json' 文件配置 MCP 服务器。

以下是一个配置示例，展示如何配置 'stripe', 'supabase' 和 'github' 三个 MCP 服务器。本仓库主要关注 'Claude Desktop Tools' 部分，'Cursor IDE Integrations' 部分的服务器配置仅为示例，具体服务器实现不在本仓库中。

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp"
      ],
      "env": {
        "STRIPE_SECRET_KEY": "your_stripe_test_key_here"
      }
    },
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "your_supabase_access_token_here"
      ]
    },
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_personal_access_token_here"
      }
    }
  }
}

配置步骤:

在项目根目录下创建 '.cursor' 目录（如果不存在）。
创建 '.cursor/mcp.json' 配置文件。
根据需要修改和配置 'stripe', 'supabase' 和 'github' 服务器，并替换占位符 API 密钥和令牌。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您应该能够调用这些工具。例如，在 Claude Desktop 中，您可以指示 Claude 使用 "weather" 服务器的 'get_alerts' 工具查询天气警报，或者使用 "files" 服务器的 'list_directory' 工具列出目录内容。具体的调用方式取决于 LLM 客户端的实现。

示例 (Claude Desktop):

在 Claude 中，您可以尝试类似以下的指令来使用这些工具：

@weather get alerts for California
@files list directory of Downloads
@whatsapp analyze chat file path/to/your/chat.txt

请参考对应 LLM 客户端的文档，了解如何在其界面中触发和使用 MCP 服务器提供的工具。

关键词