日期时间服务

一个提供日期时间功能、用户配置文件和个性化问候的MCP服务器。

  • by MarcinMalczewski
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 marcinmalczewski/mcp

使用说明

日期和时间MCP服务器

一个简单的模型上下文协议(MCP)服务器,提供日期和时间功能,以及示例用户配置文件和问候资源。

特性

  • 获取任何时区的当前日期和时间
  • 按ID访问用户配置文件
  • 获得个性化问候

安装

  1. 克隆此存储库
  2. 安装依赖项:
pip install -r requirements.txt

用法

运行服务器

使用以下命令启动服务器:

python src/server.py

服务器将于启动 http://127.0.0.1:8001 具有以下端点:

  • 工具:
    • current_datetime(timezone: str):获取特定时区的当前日期和时间
  • 资源:
    • users://{user_id}/profile:按ID获取用户的个人资料
    • greeting://{name}:获得个性化问候

运行客户端

使用以下命令运行示例客户端:

python src/client.py

客户将:

  1. 列出所有可用工具
  2. 列出所有可用资源
  3. 打电话给 current_datetime 带有“美国/纽约”时区的工具

运行LangChain客户端示例

本项目包括一个使用MCP服务器和LangChain的示例,基于 langchain mcp适配器 存储库。

要运行LangChain客户端示例:

  1. 首先,确保MCP服务器正在运行:
python src/server.py
  1. 将您的OpenAI API密钥设置为环境变量:
# On Windows
set OPENAI_API_KEY=your-api-key-here

# On Unix/Linux/MacOS
export OPENAI_API_KEY=your-api-key-here
  1. 运行LangChain客户端:
python src/langchain_client.py

LangChain客户端演示了如何将MCP服务器与LangChain的代理系统集成,从而允许对可用工具进行更复杂的交互和推理。

光标配置

要将此服务器与Cursor IDE一起使用,您需要在Cursor设置中对其进行配置。创建或更新 mcp.json Cursor配置目录中的文件,其中包含以下内容:

{
  "mcpServers": {
    "my-mcp-local-server": {
      "command": "path/to/your/python.exe",
      "args": [
        "path/to/your/server.py"
      ],
      "description": "MCP local server"
    },
    "my-mcp-remote-server": {
      "url": "http://127.0.0.1:8001/mcp",
      "description": "MCP remote server"
    }
  }
}

此配置提供了两种连接到服务器的方法:

  1. my-mcp-local-server:通过Python在本地运行服务器
  2. my-mcp-remote-server:连接到端口8001上运行的服务器

确保用实际的Python和服务器脚本路径替换路径。

API使用示例

获取当前时间

result = await client.call_tool("current_datetime", {"timezone": "America/New_York"})

获取用户资料

profile = await client.read_resource("users://123/profile")

获得问候

greeting = await client.read_resource("greeting://John")

发展

该服务器是使用FastMCP构建的,它提供了一种创建MCP兼容服务器的简单方法。主要部件有:

  • server.py:包含服务器实现以及工具和资源
  • client.py:演示如何与服务器交互的示例客户端

许可证

麻省理工学院