🚀 Moodle-MCP 服务器实现

本项目致力于实现 Moodle-MCP 服务器，可获取 Moodle 中的即将进行的活动。不过需要注意的是，该项目仍在开发中，目前仅部分功能可用。

🚀 快速开始

本项目目前仍在开发阶段，仅部分功能可用，使用时请留意。

✨ 主要特性

• [x] 获取Moodle中的即将进行的活动

📚 详细文档

有关可用的Moodle API函数，请参阅官方文档。

📦 安装指南

方法 1: 使用 mcp CLI（推荐）

1. 从 .env.example 模板创建您自己的 .env 文件。
2. 假设您已安装 uv，运行 uv add "mcp[cli]" 以安装MCP CLI工具。
3. 运行 mcp install main.py -f .env 将Moodle-MCP服务器添加到Claude应用中。

方法 2: 使用 uvx

转到Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，以包含以下内容：

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "uvx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://{your-moodle-url}/webservice/rest/server.php",
        "MOODLE_TOKEN": "{your-moodle-token}"
      }
    }
  }
}

🔧 技术细节

认证

获取您的Moodle令牌

1. 导航到您的Moodle令牌管理页面 https://{your-moodle-url}/user/managetoken.php。
2. 在Service列中使用带有Moodle移动网络服务的令牌。
3. 将此令牌添加到您的.env文件中。

⚠️ 重要提示

该项目仍在开发中，仅部分功能可用。使用时请关注功能的完整性。

💡 使用建议

安装时推荐使用 mcp CLI 方法，操作相对简便。