使用说明

项目简介

Schedulia MCP 是一个基于 Model Context Protocol (MCP) 构建的会议调度助手。它作为一个 MCP 服务器，旨在为大型语言模型 (LLM) 客户端提供结构化的工具，以便用户可以通过自然语言与会议日程进行交互，例如查看日程、发送会议请求、回复会议邀请等。

主要功能点

查看会议日程 (view_meeting_schedules): 允许用户查询指定日期的会议安排。
查看会议请求 (view_meeting_requests): 允许用户查看待处理的会议邀请。
回复会议请求 (respond_to_meeting_request): 允许用户接受或拒绝会议邀请，并选择合适的时间。
发送会议请求 (request_meeting): 允许用户向指定邮箱发送新的会议邀请，并提供可选的时间段。

安装步骤

安装 Git: 如果您的系统上没有安装 Git，请先安装 Git。
安装 Python: 确保您的系统已安装 Python。建议使用 Python 3.7 或更高版本。
安装 UV 包管理器: 按照 UV 安装指南安装 UV 包管理器。

克隆仓库: 使用 Git 克隆 'schedulia-mcp' 仓库到本地：

git clone https://github.com/watanka/schedulia-mcp.git
cd schedulia-mcp

运行服务器: 在仓库目录下，使用 UV 运行 'server.py' 脚本，并提供您的 API 密钥。您需要先从 schedulia.org 获取 API 密钥。

uv run server.py --api-key={your-api-key}  # 将 {your-api-key} 替换为您的 API 密钥

服务器配置

要将 Schedulia MCP 服务器配置到您的 MCP 客户端（如 Claude Desktop 或 Cursor），您需要提供以下 JSON 配置信息。请根据您的实际情况修改路径和 API 密钥。

{
    "mcpServers": {
        "schedulia-mcp": {  // 服务器名称，可以自定义
            "command": "uv",  // 启动服务器的命令，这里使用 uv 包管理器
            "args": [       // 启动命令的参数列表
                "--directory",  // 指定工作目录
                "/path/to/mcp/server",  // 替换为您的 schedulia-mcp 仓库的绝对路径
                "run",          // uv 的 run 命令，用于运行 Python 脚本
                "server.py",    // 要运行的服务器脚本
                "--api-key",    // 传递 API 密钥的参数
                "{your-api-key}" // 替换为您的 API 密钥
            ]
        }
    }
}

请注意:

请将 '/path/to/mcp/server' 替换为您本地 'schedulia-mcp' 仓库的绝对路径。
请将 '{your-api-key}' 替换为您从 schedulia.org 获取的真实 API 密钥。
此配置信息需要添加到您的 MCP 客户端的配置文件中。具体配置方法请参考 Claude Desktop 配置指南或 Cursor 配置指南。

基本使用方法

配置完成后，您可以在支持 MCP 协议的 LLM 客户端中使用自然语言指令来调用 Schedulia MCP 提供的工具，例如：

查看今日会议: "请使用 view_meeting_schedules 工具查看今天的会议日程"
查看会议请求: "请使用 view_meeting_requests 工具查看我的会议请求"
接受会议请求 (假设请求 ID 为 1): "请使用 respond_to_meeting_request 工具接受请求 ID 为 1 的会议邀请"
发起会议请求 (与 [email protected] 开会，主题为项目启动，可选时间为 3 月 25 日下午 2 点): "请使用 request_meeting 工具向 [email protected] 发送会议请求，主题为项目启动，可选时间为 2024-03-25 下午 2 点"

请参考 README.md 文件中 “🛠️ Available Tools” 部分的详细工具说明和 Prompt 示例，以便更有效地使用 Schedulia MCP。

关键词