Moodle MCP

🚀 Moodle - MCP 服务器实现

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

🚀 快速开始

本项目目前处于开发阶段，部分功能可用。在使用前，请参考以下安装和认证步骤。

✨ 主要特性

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

📦 安装指南

方法 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}"
      }
    }
  }
}

📚 详细文档

API 参考

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

认证

获取您的Moodle令牌

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

⚠️ 重要提示

该项目仍在开发中，仅部分功能可用。

💡 使用建议

推荐使用 mcp CLI 进行安装。