项目简介

本项目是基于 Model Context Protocol (MCP) 构建的服务器实现,旨在为大型语言模型 (LLM) 客户端提供与 EnkAI 事件调度服务交互的能力。通过标准的 MCP 接口,LLM 可以调用此服务器提供的工具,从而根据用户的自然语言指令自动化创建和管理事件的日程安排。

主要功能点

  • 创建事件调度页面: LLM 可以通过调用服务器提供的工具,向 EnkAI 平台提交活动标题、描述和候选日期选项,创建一个用于协调参与者日程的活动页面,并获取该页面的管理链接。
  • 获取日历信息: 提供工具帮助 LLM 获取特定月份的日期与工作日映射关系,辅助理解和解析用户提出的日期要求(如“下周三”、“月底”等)。
  • 获取当前日期: 提供工具帮助 LLM 获取当前日期,作为处理相对日期指令(如“明天”、“今天”)的参考。

这些功能使得 LLM 能够更好地理解用户关于事件日程安排的意图,并通过自动化调用工具,将用户需求转化为 EnkAI 平台上的实际操作。

安装步骤

此服务器通常作为 MCP 客户端的依赖项运行。您可以按照以下步骤克隆并在本地构建:

  1. 克隆仓库:
    git clone https://github.com/k-kohey/enkai-mcp
    cd enkai-mcp
  2. 安装依赖:
    npm install
  3. 构建项目:
    npm run build

构建完成后,生成的可执行文件通常会位于 'build' 目录下,或者可以通过 'npx' 直接运行。

服务器配置(MCP 客户端使用)

要让支持 MCP 的客户端(如 Raycast 等)使用此服务器,您需要在客户端中添加对此服务器的配置。配置通常是一个 JSON 对象,指定客户端如何启动和连接到 MCP 服务器。

以下是基于仓库信息生成的典型配置示例,您的客户端可能需要通过界面或配置文件导入:

{
  "mcpServers": {
    "enkai-mcp-server": {
      "type": "stdio", 
      "command": "npx",
      "args": [
        "enkai-mcp"
        // 可以在这里指定版本,例如 "enkai-mcp@latest" 或 "[email protected]"
      ]
    }
    // ... 其他 MCP 服务器配置
  }
}
  • 'type': 指定传输协议,'stdio' 表示通过标准输入/输出进行通信。
  • 'command': 启动 MCP 服务器进程的命令,此处使用 'npx' 来执行安装好的 Node.js 包。
  • 'args': 传递给命令的参数,'enkai-mcp' 是包的名称。

具体配置步骤请参考您使用的 MCP 客户端的文档。

基本使用方法

配置完成后,当您在 MCP 客户端中与 LLM 交互,提出需要安排事件日程的需求时(例如:“我想安排一个周五的团队聚餐”),LLM 会:

  1. 识别出日程安排的需求。
  2. 调用 'getCalendarInfoForMonth' 和 'getCurrentISODate' 等工具来解析日期信息,确定可能的候选日期。
  3. 调用 'createEventPage' 工具,将聚餐的标题、描述和确定的候选日期作为参数发送给此 MCP 服务器。
  4. MCP 服务器接收请求,调用后端 EnkAI 平台的 API 创建事件。
  5. MCP 服务器将创建成功的活动管理页面的 URL 返回给 LLM。
  6. LLM 将该 URL 提供给用户,用户可以打开链接进行后续的日程协调和参与者确认。

整个过程对用户是无感知的工具调用,最终用户只需要通过 LLM 获得事件管理链接。

信息

分类

生产力应用