项目简介

本项目 'mcp-server' 是一个基于 Model Context Protocol (MCP) 的服务器实现，专注于提供实用的日期时间功能和声音播放工具。它设计用于与支持 MCP 协议的客户端（如 Cursor IDE）集成，扩展客户端的功能。

主要功能点

获取当前日期时间：以 ISO 8601 格式返回当前日期和时间，方便在各种场景中使用，如记录时间戳、版本控制等。
播放提示音：提供“完成”和“确认”两种提示音的播放功能，用于在 MCP 客户端操作完成或需要用户确认时提供听觉反馈。

安装步骤

克隆仓库

git clone https://github.com/mamisoa/mcp-server.git
cd mcp-server

安装依赖

确保已安装 Python 3.x 和 Poetry。然后使用 Poetry 安装项目依赖：
```
poetry install
```

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Cursor IDE）集成，您需要在客户端的 MCP 配置文件中添加服务器配置信息。以 Cursor IDE 为例，编辑 '~/.cursor/mcp.json' 文件，添加以下配置：

配置日期时间服务器 (mcp-datetime.py):

{
  "mcpServers": {
    "datetime": {
      "command": "poetry",
      "args": [
        "run",
        "python",
        "/path/to/your/mcp-server/mcp_server/mcp-datetime.py"
      ],
      "serverName": "DateTimeServer"
    }
  }
}

配置实用工具服务器 (mcp-utils.py，包含日期时间和声音播放):

{
  "mcpServers": {
    "utils": {
      "command": "poetry",
      "args": [
        "run",
        "python",
        "/path/to/your/mcp-server/mcp_server/mcp-utils.py"
      ],
      "serverName": "UtilsServer"
    }
  }
}

注意:

将 '/path/to/your/mcp-server' 替换为您实际的仓库安装路径。
'"serverName"' 字段的值必须与 Python 代码中 'FastMCP()' 构造函数中指定的服务器名称一致 ('FastMCP("DateTimeServer")' 或 'FastMCP("UtilsServer")')。
您可以选择配置日期时间服务器或实用工具服务器，或者同时配置两者，根据您的需求选择合适的服务器配置文件添加到 'mcp.json' 中。

基本使用方法

配置完成后，MCP 客户端应该能够连接到此服务器并调用其提供的工具。具体使用方法取决于 MCP 客户端的功能。

例如，在 Cursor IDE 中，您可能可以使用集成的命令或快捷方式来调用 'get_current_datetime' 工具获取当前时间，或者在特定事件（如代码完成、操作确认）时触发 'play_done_sound' 或 'play_confirmation_sound' 工具来播放提示音。

请参考您的 MCP 客户端（如 Cursor IDE）的文档，了解如何调用和使用已配置的 MCP 服务器提供的工具。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息