项目简介
本项目是基于 Model Context Protocol (MCP) 构建的服务器实现,旨在为大型语言模型 (LLM) 客户端提供与 EnkAI 事件调度服务交互的能力。通过标准的 MCP 接口,LLM 可以调用此服务器提供的工具,从而根据用户的自然语言指令自动化创建和管理事件的日程安排。
主要功能点
- 创建事件调度页面: LLM 可以通过调用服务器提供的工具,向 EnkAI 平台提交活动标题、描述和候选日期选项,创建一个用于协调参与者日程的活动页面,并获取该页面的管理链接。
- 获取日历信息: 提供工具帮助 LLM 获取特定月份的日期与工作日映射关系,辅助理解和解析用户提出的日期要求(如“下周三”、“月底”等)。
- 获取当前日期: 提供工具帮助 LLM 获取当前日期,作为处理相对日期指令(如“明天”、“今天”)的参考。
这些功能使得 LLM 能够更好地理解用户关于事件日程安排的意图,并通过自动化调用工具,将用户需求转化为 EnkAI 平台上的实际操作。
安装步骤
此服务器通常作为 MCP 客户端的依赖项运行。您可以按照以下步骤克隆并在本地构建:
- 克隆仓库:
git clone https://github.com/k-kohey/enkai-mcp cd enkai-mcp - 安装依赖:
npm install - 构建项目:
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 会:
- 识别出日程安排的需求。
- 调用 'getCalendarInfoForMonth' 和 'getCurrentISODate' 等工具来解析日期信息,确定可能的候选日期。
- 调用 'createEventPage' 工具,将聚餐的标题、描述和确定的候选日期作为参数发送给此 MCP 服务器。
- MCP 服务器接收请求,调用后端 EnkAI 平台的 API 创建事件。
- MCP 服务器将创建成功的活动管理页面的 URL 返回给 LLM。
- LLM 将该 URL 提供给用户,用户可以打开链接进行后续的日程协调和参与者确认。
整个过程对用户是无感知的工具调用,最终用户只需要通过 LLM 获得事件管理链接。
信息
分类
生产力应用