使用说明

项目简介

本项目 'test-mcp' 是一个使用 Python 和 FastMCP 框架实现的 Model Context Protocol (MCP) 服务器示例。它旨在演示如何构建一个 MCP 服务器，并提供了一系列示例工具，如获取天气信息、笑话、名言警句、书籍推荐以及模拟邮件列表等。该服务器可以与支持 MCP 协议的 LLM 客户端（如 Claude Desktop 或 Cline Extension）配合使用，为 LLM 应用提供上下文信息和外部功能调用能力。

主要功能点

工具 (Tools)：
- 通用工具：
  - 'say_hello'：向指定用户打招呼。
  - 'cat_fact'：获取一个随机猫咪趣闻。
  - 'suggest_book'：推荐一本随机书籍。
  - 'tell_joke'：讲一个笑话。
  - 'find_inspiration'：获取一句励志名言。
  - 'get_weather'：查询指定城市的天气信息。
- 邮件工具 (模拟)：
  - 'list_emails'：列出模拟的最新邮件元数据（主题、发件人等）。
  - 'get_email_body'：获取指定 UUID 邮件的详细内容。
  - 'reply_email'：模拟回复指定 UUID 的邮件。

安装步骤

安装 uv (Python 环境管理工具): 如果还没有安装 uv，请根据 uv 官方文档安装。uv 可以帮助你更方便地管理 Python 环境和依赖。

克隆仓库：将 'test-mcp' 仓库克隆到本地。

git clone https://github.com/mrexodia/test-mcp.git
cd test-mcp

运行 MCP 服务器：使用 uv 运行 'server.py' 脚本启动 MCP 服务器。
```
uv run mcp dev server.py
```
服务器默认使用 'stdio' 作为传输协议。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），你需要提供服务器的启动命令和参数。以下是一个 'claude_desktop_config.json' 示例配置，你可以将其添加到 Claude Desktop 的配置文件中。

{
  "mcpServers": {
    "Test MCP": { // 服务器名称，在客户端中显示
      "command": "uv", // 启动服务器的命令，这里使用 uv
      "args": [ // 启动命令的参数列表
        "--directory", // 指定工作目录参数
        "/Users/admin/Projects/test-mcp", //  请替换为你的 test-mcp 仓库的本地路径
        "run", // uv 的 run 命令，用于运行脚本
        "server.py" // 要运行的服务器脚本
      ],
      "timeout": 600 // 服务器启动超时时间，单位秒
    }
  }
}

请注意：你需要将 '"/Users/admin/Projects/test-mcp"' 替换为你本地 'test-mcp' 仓库的实际路径。

基本使用方法

启动 MCP 服务器：按照上述安装步骤运行 'server.py'。
配置 MCP 客户端：将上述 'claude_desktop_config.json' 中的配置添加到你的 MCP 客户端配置中，并确保路径正确。
在 MCP 客户端中使用工具：连接到 "Test MCP" 服务器后，你就可以在 MCP 客户端中调用服务器提供的工具了。例如，在 Claude Desktop 中，你可以通过 '@Test MCP:工具名' 的形式来调用工具，例如 '@Test MCP:say_hello name="User"' 或 '@Test MCP:get_weather city="London"'。

关键词