article
README
🚀 东北大学日历 MCP 服务器
本 MCP 服务器借助模型上下文协议(MCP),为用户提供对东北大学活动日历的便捷访问。Claude Desktop 可通过该服务器实现对东北大学日历事件的检索、搜索和筛选操作。
🚀 快速开始
此 MCP 服务器通过模型上下文协议(MCP)提供对东北大学活动日历的访问。Claude Desktop 可以使用它来检索、搜索和筛选东北大学的日历事件。
✨ 主要特性
- 获取今日事件
- 获取未来指定天数内的待办事件
- 根据关键词搜索事件
- 按类别过滤事件
- 获取特定事件的详细信息
- 列出可用的事件类别
📦 安装指南
- 克隆或下载此仓库。
- 创建虚拟环境:
python -m venv venv - 启动虚拟环境:
- 在 macOS/Linux 上:
source venv/bin/activate - 在 Windows 上:
venv\Scripts\activate
- 在 macOS/Linux 上:
- 安装所需的依赖项:
pip install -r requirements.txt
💻 使用示例
运行 MCP 服务器
- 确保激活了虚拟环境。
- 启动服务器:
python neu_calendar_server.py - 服务器将默认在 localhost 端口 8000 上运行。
与 Claude Desktop 连接
有关设置 MCP 服务器与 Claude Desktop 的详细说明,请参阅 CLAUDE_DESKTOP_SETUP.md。
快速设置步骤如下:
- 打开 Claude Desktop。
- 转到设置 -> 开发者。
- 点击“编辑配置”。
- 添加 NEU 日历 MCP 服务器的配置。
- 重启 Claude Desktop。
使用扩展功能
一旦扩展程序安装完成且服务器运行,您就可以让 Claude 查询有关东北大学事件的信息。例如:
- “今天在东北大学有什么活动吗?”
- “显示未来一周的活动”
- “这个月有任何研讨会吗?”
- “告诉我关于东北大学的体育赛事”
- “有哪些可用的活动类别?”
📚 详细文档
截图
以下是 NEU 日历 MCP 服务器运行示例的一些截图:
可用 MCP 工具
NEU 日历 MCP 服务器提供了多个工具,用于与东北大学日历交互。
示例查询
Claude 查询未来一周的活动示例。
类别搜索 - 体育赛事
Claude 搜索并显示即将进行的体育赛事。
详细信息请求
Claude 提供特定事件的详细信息。例如,上面的情况中,Claude 确定了该活动与自己有关。
工具使用权限
Claude 在执行日历搜索工具之前请求使用权限。
故障排除
- 如果 Claude 无法连接到服务器,请确保服务器正在运行,并且端口(8000)未被防火墙阻止。
- 如果出现错误,请检查控制台中的输出,以获取更多调试信息。
📄 许可证
项目用途:此项目仅供教育和研究目的使用。请尊重所有适用的许可证和条款。
🔧 技术细节
- MCP 协议:用于跨应用程序的数据交换。
- Claude Desktop:用于演示日历功能集成。
扫码联系在线客服